# create_session

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

> Start a pane's configured process; accepts no command payload. Creates a detached session whose first pane runs the configured process.

MCP is in development

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

Start a pane’s configured process; accepts no command payload. Creates a detached session whose first pane runs the configured process.

[All Go tools](https://libtmux.org/en/go/latest/mcp/tools/) · [JSON](https://libtmux.org/en/go/latest/mcp/tools/create_session.json) · [Source](https://github.com/libtmux/libtmux-go/blob/aaf86678fe0cbdf56f9e1c9c46b0db0704e15656/mcp/manifest_catalog.go#L435)

## Arguments

* `height` optional · integer

  initial height; supply with width

* `session_name` optional · string

  a literal session name

* `start_directory` optional · string

  an absolute literal start directory

* `width` optional · integer

  initial width; supply with height

* `window_name` optional · string

  a literal first-window name

## Schemas

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

Input schema

```json
{
  "additionalProperties": false,
  "properties": {
    "height": {
      "description": "initial height; supply with width",
      "type": "integer"
    },
    "session_name": {
      "description": "a literal session name",
      "type": "string"
    },
    "start_directory": {
      "description": "an absolute literal start directory",
      "type": "string"
    },
    "width": {
      "description": "initial width; supply with height",
      "type": "integer"
    },
    "window_name": {
      "description": "a literal first-window name",
      "type": "string"
    }
  },
  "type": "object"
}
```

Output schema

```json
{
  "additionalProperties": false,
  "properties": {
    "sessionId": {
      "type": "string"
    },
    "sessionName": {
      "type": "string"
    }
  },
  "required": [
    "sessionId",
    "sessionName"
  ],
  "type": "object"
}
```

Tool annotations

```json
{
  "destructiveHint": true,
  "openWorldHint": true,
  "title": "Create a session"
}
```