{
  "name": "run_shell_command",
  "wireName": "run_shell_command",
  "source": {
    "repo": "libtmux/libtmux-dotnet",
    "revision": "320dc64f4b8b7815842471327a5e6b84a1499bf8",
    "extractedRevision": "b243b2cf82de4e98e2172aba4f54a52b9c363dc4",
    "file": "src/LibTmux.Mcp/Policy/CapabilityModel.cs",
    "line": 596
  },
  "description": "Run a shell command in a pane with your user's permissions. Run a shell command in one pane, wait for it to finish, and report its singular real exit status and output. This is the tool for 'run X and tell me if it worked'. It reaches only the pane you name: the command travels through a tmux buffer, which synchronize-panes does not fan out, so the exit status is one pane's. Use send_keys when you want a synchronized cohort to receive input. Do NOT send keys and then poll a capture in a loop — this waits deterministically and costs one call. The command runs in a subshell, so cd and export do not persist. It refuses the named pane in a human-owned mode. Check linesMissed and anchorLost. A timed-out command MAY STILL BE RUNNING; inspect it and do not retry it — unless started is false, which means it never ran because something other than an idle shell was reading that pane's input.",
  "schemaStatus": "runtime",
  "inputSchema": {
    "additionalProperties": false,
    "properties": {
      "command": {
        "description": "The shell command.",
        "type": "string"
      },
      "maxLines": {
        "default": null,
        "description": "Maximum returned lines.",
        "maximum": 2147483647,
        "minimum": -2147483648,
        "type": [
          "integer",
          "null"
        ]
      },
      "paneId": {
        "default": null,
        "description": "A pane id. Omit for the active pane.",
        "type": [
          "string",
          "null"
        ]
      },
      "suppressHistory": {
        "default": false,
        "description": "Keep the command out of shell history on a best-effort basis.",
        "type": "boolean"
      },
      "timeoutSeconds": {
        "default": null,
        "description": "Requested timeout in seconds.",
        "type": [
          "number",
          "null"
        ]
      }
    },
    "required": [
      "command"
    ],
    "type": "object"
  },
  "outputSchema": {
    "properties": {
      "anchorLost": {
        "default": false,
        "type": "boolean"
      },
      "effectiveTimeoutSeconds": {
        "type": "number"
      },
      "elapsedSeconds": {
        "type": "number"
      },
      "exitStatus": {
        "type": [
          "integer",
          "null"
        ]
      },
      "linesMissed": {
        "default": false,
        "type": "boolean"
      },
      "output": {
        "properties": {
          "droppedBytes": {
            "type": "integer"
          },
          "droppedLines": {
            "type": "integer"
          },
          "lines": {
            "items": {
              "type": "string"
            },
            "type": "array"
          },
          "truncated": {
            "type": "boolean"
          }
        },
        "required": [
          "lines",
          "truncated",
          "droppedLines",
          "droppedBytes"
        ],
        "type": "object"
      },
      "paneId": {
        "type": "string"
      },
      "started": {
        "default": true,
        "type": "boolean"
      },
      "timedOut": {
        "type": "boolean"
      }
    },
    "required": [
      "paneId",
      "exitStatus",
      "timedOut",
      "output",
      "elapsedSeconds",
      "effectiveTimeoutSeconds"
    ],
    "type": "object"
  },
  "annotations": {
    "destructiveHint": true,
    "idempotentHint": false,
    "openWorldHint": true,
    "readOnlyHint": false,
    "title": "Run shell command"
  },
  "meta": {
    "com.git-pull.libtmux-mcp/capability": {
      "amplifiesFutureInput": false,
      "inputLiteralization": {},
      "mayExposeSecrets": true,
      "mayReturnUntrustedContent": true,
      "name": "run_shell_command",
      "nestedAuthority": [],
      "outputClasses": [
        "terminal-content",
        "tmux-metadata"
      ],
      "processReach": "pane-command",
      "tmuxEffects": [
        "change",
        "observe"
      ],
      "toolset": "execute"
    }
  }
}