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.
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 | |||