# create_session

Source: https://libtmux.org/en/julia/latest/mcp/tools/create_session/

> Start an argv command in a new application-owned session. Requires allow_create; the session is removed when the application closes. Completion means creation, not command exit.

toolMCPlatest

MCP is in development

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

* **create_session**( [command](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.input%2Fproperties%2Fcommand): [Array](https://json-schema.org/understanding-json-schema/reference/array "Array (JSON Schema)")<[string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)")>, [name](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.input%2Fproperties%2Fname): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)"), )

  tool[\[source\]](https://github.com/libtmux/libtmux-julia/blob/f3da513be1225d36d5854cd8db5972c01857578e/packages/LibTmuxMCP/src/tools.jl#L9)[¶](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session)

  Start an argv command in a new application-owned session. Requires allow_create; the session is removed when the application closes. Completion means creation, not command exit.

  * MCP request method

    `tools/call` Send `create_session` as the tool name, with the arguments below.

  * Tool selection

    Opt in with `--tool create_session`.

  ## Arguments[#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.parameters)

  * additionalProperties

    `false`

  - [**command**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.input%2Fproperties%2Fcommand): [Array](https://json-schema.org/understanding-json-schema/reference/array "Array (JSON Schema)")<[string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)")> Required [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.input%2Fproperties%2Fcommand)

    Executable and argv; no shell expansion

    * minItems

      `1`

    * maxItems

      `32`

    - [**Items**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.input%2Fproperties%2Fcommand%2Fitems): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.input%2Fproperties%2Fcommand%2Fitems)

      Valid UTF-8; at most 1024 bytes

      * maxLength

        `1024`

  - [**name**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.input%2Fproperties%2Fname): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.input%2Fproperties%2Fname)

    Valid UTF-8; at most 64 bytes

    * maxLength

      `64`

    * pattern

      `"^[A-Za-z0-9_-]+$"`

  ## Result[#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.result)

  Returns [object](https://json-schema.org/understanding-json-schema/reference/object "object (JSON Schema)") | [object](https://json-schema.org/understanding-json-schema/reference/object "object (JSON Schema)")

  Matches one or more variants.

  * [**Variant 1**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0): [object](https://json-schema.org/understanding-json-schema/reference/object "object (JSON Schema)") [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0)

    * additionalProperties

      `false`

    - [**completed**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0%2Fproperties%2Fcompleted): [boolean](https://json-schema.org/understanding-json-schema/reference/boolean "boolean (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0%2Fproperties%2Fcompleted)

    - [**generation**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0%2Fproperties%2Fgeneration): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0%2Fproperties%2Fgeneration)

    - [**ownership**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0%2Fproperties%2Fownership): "application" Required [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0%2Fproperties%2Fownership)

    - [**panes**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0%2Fproperties%2Fpanes): [Array](https://json-schema.org/understanding-json-schema/reference/array "Array (JSON Schema)")<[object](https://json-schema.org/understanding-json-schema/reference/object "object (JSON Schema)")> Required [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0%2Fproperties%2Fpanes)

      * maxItems

        `256`

      - [**Items**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0%2Fproperties%2Fpanes%2Fitems): [object](https://json-schema.org/understanding-json-schema/reference/object "object (JSON Schema)") [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0%2Fproperties%2Fpanes%2Fitems)

        * additionalProperties

          `false`

        - [**generation**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0%2Fproperties%2Fpanes%2Fitems%2Fproperties%2Fgeneration): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0%2Fproperties%2Fpanes%2Fitems%2Fproperties%2Fgeneration)

          Opaque generation from [list_panes](https://libtmux.org/en/julia/latest/mcp/tools/list_panes/)

          * maxLength

            `128`

        - [**paneId**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0%2Fproperties%2Fpanes%2Fitems%2Fproperties%2FpaneId): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0%2Fproperties%2Fpanes%2Fitems%2Fproperties%2FpaneId)

          Valid UTF-8; at most 64 bytes

          * maxLength

            `64`

          * pattern

            `"^%(0|[1-9][0-9]*)$"`

    - [**sessionId**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0%2Fproperties%2FsessionId): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F0%2Fproperties%2FsessionId)

  * [**Variant 2**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F1): [object](https://json-schema.org/understanding-json-schema/reference/object "object (JSON Schema)") [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F1)

    * [**error**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F1%2Fproperties%2Ferror): [object](https://json-schema.org/understanding-json-schema/reference/object "object (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F1%2Fproperties%2Ferror)

      * additionalProperties

        `false`

      - [**code**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F1%2Fproperties%2Ferror%2Fproperties%2Fcode): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F1%2Fproperties%2Ferror%2Fproperties%2Fcode)

      - [**effects**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F1%2Fproperties%2Ferror%2Fproperties%2Feffects): "none" | "possible" Required [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F1%2Fproperties%2Ferror%2Fproperties%2Feffects)

      - [**message**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F1%2Fproperties%2Ferror%2Fproperties%2Fmessage): [string](https://json-schema.org/understanding-json-schema/reference/string "string (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F1%2Fproperties%2Ferror%2Fproperties%2Fmessage)

      - [**retryable**](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F1%2Fproperties%2Ferror%2Fproperties%2Fretryable): [boolean](https://json-schema.org/understanding-json-schema/reference/boolean "boolean (JSON Schema)") Required [#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.output%2FanyOf%2F1%2Fproperties%2Ferror%2Fproperties%2Fretryable)

  ## Annotations[#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.annotations)

  * [`destructiveHint`](https://libtmux.org/en/julia/latest/mcp/reference/glossary/#destructiveHint)

    `false`

  * [`idempotentHint`](https://libtmux.org/en/julia/latest/mcp/reference/glossary/#idempotentHint)

    `false`

  * [`openWorldHint`](https://libtmux.org/en/julia/latest/mcp/reference/glossary/#openWorldHint)

    `true`

  * [`readOnlyHint`](https://libtmux.org/en/julia/latest/mcp/reference/glossary/#readOnlyHint)

    `false`

  ## Protocol data[#](https://libtmux.org/en/julia/latest/mcp/tools/create_session/#mcp.tool.create_session.schemas)

  Use the complete advertised contract for validation and client integration.

  Input schema

  ```json
  {
    "additionalProperties": false,
    "properties": {
      "command": {
        "description": "Executable and argv; no shell expansion",
        "items": {
          "description": "Valid UTF-8; at most 1024 bytes",
          "maxLength": 1024,
          "type": "string"
        },
        "maxItems": 32,
        "minItems": 1,
        "type": "array"
      },
      "name": {
        "description": "Valid UTF-8; at most 64 bytes",
        "maxLength": 64,
        "pattern": "^[A-Za-z0-9_-]+$",
        "type": "string"
      }
    },
    "required": [
      "name",
      "command"
    ],
    "type": "object"
  }
  ```

  Output schema

  ```json
  {
    "anyOf": [
      {
        "additionalProperties": false,
        "properties": {
          "completed": {
            "type": "boolean"
          },
          "generation": {
            "type": "string"
          },
          "ownership": {
            "const": "application"
          },
          "panes": {
            "items": {
              "additionalProperties": false,
              "properties": {
                "generation": {
                  "description": "Opaque generation from list_panes",
                  "maxLength": 128,
                  "type": "string"
                },
                "paneId": {
                  "description": "Valid UTF-8; at most 64 bytes",
                  "maxLength": 64,
                  "pattern": "^%(0|[1-9][0-9]*)$",
                  "type": "string"
                }
              },
              "required": [
                "paneId",
                "generation"
              ],
              "type": "object"
            },
            "maxItems": 256,
            "type": "array"
          },
          "sessionId": {
            "type": "string"
          }
        },
        "required": [
          "completed",
          "panes",
          "sessionId",
          "generation",
          "ownership"
        ],
        "type": "object"
      },
      {
        "properties": {
          "error": {
            "additionalProperties": false,
            "properties": {
              "code": {
                "type": "string"
              },
              "effects": {
                "enum": [
                  "none",
                  "possible"
                ]
              },
              "message": {
                "type": "string"
              },
              "retryable": {
                "type": "boolean"
              }
            },
            "required": [
              "code",
              "message",
              "effects",
              "retryable"
            ],
            "type": "object"
          }
        },
        "required": [
          "error"
        ],
        "type": "object"
      }
    ],
    "type": "object"
  }
  ```