MCPAPI Reference

Choose documentation 3

latest

Current version

latest
English

Prerelease This site documents an alpha of libtmux. Its structure, URLs and APIs are subject to change.

create_session

Create a new detached tmux session. Start a pane’s configured process; accepts no command payload.

All Rust tools · JSON · Source

Arguments

name required · string
The name for the new session. It must not already exist.
start_directory optional · string | null
The first window's working directory. Omit for the directory this MCP server started in.

Schemas

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

Input schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"name": {
"description": "The name for the new session. It must not already exist.",
"type": "string"
},
"start_directory": {
"description": "The first window's working directory. Omit for the directory this MCP\nserver started in.",
"type": [
"string",
"null"
]
}
},
"required": [
"name"
],
"type": "object"
}
Output schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"attached": {
"description": "Whether any client is attached.",
"type": "boolean"
},
"id": {
"description": "The `$`-prefixed tmux identity.",
"type": "string"
},
"name": {
"description": "The session name, absent when tmux reported none.",
"type": "string"
},
"windows": {
"description": "How many windows the session holds.",
"minimum": 0,
"type": "integer"
}
},
"required": [
"id",
"name",
"windows",
"attached"
],
"type": "object"
}
Tool annotations
{
"destructiveHint": false,
"idempotentHint": false,
"openWorldHint": true,
"readOnlyHint": false,
"title": "Create Session"
}
Esc

Type to search.