create_session
Create a new detached tmux session. Start a pane’s configured process; accepts no command payload.
All Rust tools · JSON · Source
Arguments
namerequired · string- The name for the new session. It must not already exist.
start_directoryoptional · 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"}