# show_option

Source: https://libtmux.org/en/ts/latest/mcp/tools/show_option/

> Read configured tmux commands; accepts no client-supplied executable input. Returned values may contain executable configuration. Read one named tmux option at server, session, window, or pane scope.

MCP is in development

Server behavior and tool contracts may change. Tool availability depends on the server configuration.

Read configured tmux commands; accepts no client-supplied executable input. Returned values may contain executable configuration. Read one named tmux option at server, session, window, or pane scope.

[All TypeScript tools](https://libtmux.org/en/ts/latest/mcp/tools/) · [JSON](https://libtmux.org/en/ts/latest/mcp/tools/show_option.json) · [Source](https://github.com/libtmux/libtmux-ts/blob/b3f338c1a21e614ebf0dd6d55aa36a60db816618/packages/mcp/src/tools/settings.ts#L105)

## Arguments

* `name` required · string

  The tmux option to read, such as "status-left".

* `scope` optional · string

  Default server.

* `target` optional · string

  Session id/name or pane id, for the matching scope.

## Schemas

The schema defines required fields, nested values, defaults, and validation constraints.

Input schema

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "name": {
      "description": "The tmux option to read, such as \"status-left\".",
      "type": "string"
    },
    "scope": {
      "description": "Default server.",
      "enum": [
        "server",
        "session",
        "global-session",
        "window",
        "global-window",
        "pane"
      ],
      "type": "string"
    },
    "target": {
      "description": "Session id/name or pane id, for the matching scope.",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}
```

Output schema

```json
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false,
  "properties": {
    "name": {
      "type": "string"
    },
    "scope": {
      "type": "string"
    },
    "value": {
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "name",
    "scope",
    "value"
  ],
  "type": "object"
}
```

Tool annotations

```json
{
  "destructiveHint": true,
  "idempotentHint": false,
  "openWorldHint": true,
  "readOnlyHint": false
}
```