launch_session
Start a Claude Code session in its own tmux window and block until it is ready, optionally in an isolated git worktree for parallel work.
Instructions
Start a new session: one full Claude Code process in its own tmux window.
Blocks until Claude shows its input box (up to ~90 s) so a failed start is
reported here rather than discovered later. working_directory must be a
Linux path (/mnt/c/... for a Windows folder). model overrides the
profile's model (opus / sonnet). initial_message is delivered as the
first task once the session is ready. provider is accepted for
compatibility; only claude_code exists.
use_worktree runs the session in its own git worktree (under
MAESTRO_HOME) on a new branch mx/<terminal_id> made from the repo's
HEAD, so parallel workers on one repository never trample each other; the
result's worktree gives its path and branch. The worker is told to
commit there. Merge it yourself with plain git afterwards
(git -C <repo> merge mx/<terminal_id>). Deleting the terminal removes
the checkout after committing anything left uncommitted on the branch; the
branch is kept when it has commits the repo's HEAD lacks.
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": {
"agent_profile": "<agent_profile>"
},
"name": "launch_session"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | ||
| provider | No | ||
| session_name | No | ||
| use_worktree | No | ||
| agent_profile | Yes | ||
| initial_message | No | ||
| working_directory | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||