skills/common/misc/tmux-launch-agent/SKILL.md

name, description, disable-model-invocation

name	description	disable-model-invocation
tmux-launch-agent	Fork a new agent CLI session into a new tmux window, detected from the current agent.	true

Agent CLI Seed Data

Agent config (binary, args, modelflag) is in agents-seed.md. Step 2 reads it by name.

Dispatch

1. Detect agent — Run ./detect-agent (sibling). On success, the agent name is known. On failure (exit 1), stop.

2. Look up config — Find the agent's entry in agents-seed.md by name. Extract binary, args, and modelflag.

3. Parse flags — Scan user arguments for flags (before prompt text). For each flag, extract its value and remove both the flag and value from the argument list:

   • --name <title> / -n <title> — tmux window title
   • -c <path> — working directory (default: project directory)
   • --model <name> / -m <name> — model for child session

   Remaining text is the prompt. If --name is absent, tmux auto-names the window.

4. Build command — Assemble the inner command:

   • Start with <binary>.
   • If model specified: append <modelflag> <model-name>.
   • If prompt exists and args contains {prompt}: write to /tmp/, substitute path for {prompt}.
   • If prompt exists and args is empty: pipe via echo.
   • If no prompt: launch bare.

5. Open window — Call ./tmux-open <window-name> <start-dir> <inner-command> where <inner-command> is the assembled command from step 4 as separate arguments. On success, a new tmux window appears with the agent session active.