{
  "name": "start_program",
  "wireName": "start_program",
  "source": {
    "repo": "libtmux/libtmux-ts",
    "revision": "f7b03a361f7c97677406b4ab937b2772ddb5f7dd",
    "extractedRevision": "f7b03a361f7c97677406b4ab937b2772ddb5f7dd",
    "file": "packages/mcp/src/tools/programs.ts",
    "line": 230
  },
  "description": "Run a program in a new pane of its own with your user's permissions. Start a program in a pane of its own and return at once with a programId. Use it for a program that runs longer than one wait, such as a build or a server, or one that needs keys between reads; run_program is the one-call form. read_program reads its output as it is written and reports its exit; send_keys reaches its paneId; stop_program ends it. This server ends it and removes its pane when lifetimeMs runs out, even if no later call arrives, and tmux does if this server dies. No shell parses argv, and PAGER and GIT_PAGER are cat. It takes no input, keep, inheritShell or separateStderr: for those, use run_program. Requires tmux 3.8 or newer.",
  "schemaStatus": "runtime",
  "inputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "properties": {
      "argv": {
        "description": "The program and its arguments, as given: [\"git\", \"status\", \"--short\"]. Put variables first with env: [\"env\", \"CI=1\", \"make\", \"test\"].",
        "items": {
          "type": "string"
        },
        "maxItems": 256,
        "minItems": 1,
        "type": "array"
      },
      "fromPaneId": {
        "description": "Run beside this pane, in its directory and session, as run_program does.",
        "pattern": "^%\\d+$",
        "type": "string"
      },
      "height": {
        "description": "Rows of the program's terminal. Defaults to tmux's default-size.",
        "exclusiveMinimum": 0,
        "maximum": 10000,
        "type": "integer"
      },
      "lifetimeMs": {
        "description": "How long the program may run: it is ended and its pane removed this long after the start. 10 minutes by default; longer than 60 is cut to that.",
        "exclusiveMinimum": 0,
        "maximum": 9007199254740991,
        "type": "integer"
      },
      "placement": {
        "description": "With fromPaneId: \"window\", the default, or \"split\" beside the pane, where a person watching it sees the program. Focus stays put.",
        "enum": [
          "window",
          "split"
        ],
        "type": "string"
      },
      "startDirectory": {
        "description": "Directory the program starts in, taken literally; one that cannot be entered means the program never runs, and read_program reports not_started.",
        "type": "string"
      },
      "width": {
        "description": "Columns of the program's terminal.",
        "exclusiveMinimum": 0,
        "maximum": 10000,
        "type": "integer"
      }
    },
    "required": [
      "argv"
    ],
    "type": "object"
  },
  "outputSchema": {
    "$schema": "http://json-schema.org/draft-07/schema#",
    "additionalProperties": false,
    "properties": {
      "effectiveLifetimeMs": {
        "description": "The lifetime enforced.",
        "maximum": 9007199254740991,
        "minimum": -9007199254740991,
        "type": "integer"
      },
      "paneId": {
        "description": "The program's pane, for send_keys or capture_pane.",
        "pattern": "^%\\d+$",
        "type": "string"
      },
      "programId": {
        "description": "Pass to read_program and stop_program.",
        "type": "string"
      }
    },
    "required": [
      "effectiveLifetimeMs",
      "paneId",
      "programId"
    ],
    "type": "object"
  },
  "annotations": {
    "destructiveHint": true,
    "idempotentHint": false,
    "openWorldHint": true,
    "readOnlyHint": false
  },
  "meta": {
    "com.git-pull.libtmux-mcp/capability": {
      "amplifiesFutureInput": false,
      "annotations": {
        "destructiveHint": true,
        "idempotentHint": false,
        "openWorldHint": true,
        "readOnlyHint": false
      },
      "description": "Run a program in a new pane of its own with your user's permissions. Start a program in a pane of its own and return at once with a programId. Use it for a program that runs longer than one wait, such as a build or a server, or one that needs keys between reads; run_program is the one-call form. read_program reads its output as it is written and reports its exit; send_keys reaches its paneId; stop_program ends it. This server ends it and removes its pane when lifetimeMs runs out, even if no later call arrives, and tmux does if this server dies. No shell parses argv, and PAGER and GIT_PAGER are cat. It takes no input, keep, inheritShell or separateStderr: for those, use run_program. Requires tmux 3.8 or newer.",
      "inputLiteralization": {},
      "inputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "argv": {
            "description": "The program and its arguments, as given: [\"git\", \"status\", \"--short\"]. Put variables first with env: [\"env\", \"CI=1\", \"make\", \"test\"].",
            "items": {
              "type": "string"
            },
            "maxItems": 256,
            "minItems": 1,
            "type": "array"
          },
          "fromPaneId": {
            "description": "Run beside this pane, in its directory and session, as run_program does.",
            "pattern": "^%\\d+$",
            "type": "string"
          },
          "height": {
            "description": "Rows of the program's terminal. Defaults to tmux's default-size.",
            "exclusiveMinimum": 0,
            "maximum": 10000,
            "type": "integer"
          },
          "lifetimeMs": {
            "description": "How long the program may run: it is ended and its pane removed this long after the start. 10 minutes by default; longer than 60 is cut to that.",
            "exclusiveMinimum": 0,
            "maximum": 9007199254740991,
            "type": "integer"
          },
          "placement": {
            "description": "With fromPaneId: \"window\", the default, or \"split\" beside the pane, where a person watching it sees the program. Focus stays put.",
            "enum": [
              "window",
              "split"
            ],
            "type": "string"
          },
          "startDirectory": {
            "description": "Directory the program starts in, taken literally; one that cannot be entered means the program never runs, and read_program reports not_started.",
            "type": "string"
          },
          "width": {
            "description": "Columns of the program's terminal.",
            "exclusiveMinimum": 0,
            "maximum": 10000,
            "type": "integer"
          }
        },
        "required": [
          "argv"
        ],
        "type": "object"
      },
      "mayExposeSecrets": true,
      "mayReturnUntrustedContent": true,
      "name": "start_program",
      "nestedAuthority": [],
      "outputClasses": [
        "tmux-metadata",
        "terminal-content"
      ],
      "outputSchema": {
        "$schema": "http://json-schema.org/draft-07/schema#",
        "properties": {
          "effectiveLifetimeMs": {
            "description": "The lifetime enforced.",
            "maximum": 9007199254740991,
            "minimum": -9007199254740991,
            "type": "integer"
          },
          "paneId": {
            "description": "The program's pane, for send_keys or capture_pane.",
            "pattern": "^%\\d+$",
            "type": "string"
          },
          "programId": {
            "description": "Pass to read_program and stop_program.",
            "type": "string"
          }
        },
        "required": [
          "effectiveLifetimeMs",
          "paneId",
          "programId"
        ],
        "type": "object"
      },
      "processReach": "pane-program",
      "title": "Start a program",
      "tmuxEffects": [
        "observe",
        "change"
      ],
      "toolset": "execute"
    }
  }
}