Create an owned tmux session
new_sessionCreates a detached tmux session owned by tmux-mcp with optional working directory, shell, and initial command; returns an existing owned session unchanged and never modifies foreign sessions.
Instructions
Create a detached session owned by tmux-mcp, with an optional working directory, shell, and initial command. If an owned session with that name exists it is returned unchanged; a foreign session with that name is never modified.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>"
},
"name": "new_session"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cwd | No | Absolute working directory (default: host home) | |
| name | Yes | Session name (letters, digits, dash, underscore) | |
| shell | No | Absolute shell path (default: /usr/bin/bash) | |
| command | No | Optional command to type after creation |