Fork Terminal

Check Prerequisites

• IF: ${CLAUDE_SKILL_DIR}/scripts/fork_terminal.py not found → report missing and stop
• IF: agentic tool requested → verify binary is in PATH (which claude, which codex, which gemini)
• IF: raw CLI → verify the command exists (which <command>)
• Example: which claude succeeds → proceed
• Tool: Bash

Handle Context Handoff (Agentic Tools Only)

• IF: context handoff requested AND tool is agentic
• THEN: Read ${CLAUDE_SKILL_DIR}/prompts/context-handoff.md template
• Fill the template in memory (do NOT modify the file):
  • Replace {{CONVERSATION_SUMMARY}} with a concise summary of the conversation so far
  • Replace {{NEXT_TASK}} with the user's task for the forked session
• The filled template becomes the task/prompt for the next step
• IF: no context handoff → use the raw task as-is
• Example: user says "fork claude with context to refactor auth" → build summary, use as prompt
• Tool: Read

Build Command

• IF: raw CLI → construct command directly from user's request
• IF: agentic tool → use the reference table below to build the command with the task from step 3
• IF: user specifies a model → pass it through with the tool's model flag
• IF: user does not specify a model → omit the model flag (let the tool use its own default)
• Example: raw CLI → ffmpeg -i input.mp4 -c:v libvpx-vp9 output.webm
• Example: claude-code → claude -p "fix tests" --dangerously-skip-permissions
• Example: codex with model → codex -m o3 --dangerously-bypass-approvals-and-sandbox "fix tests"
• Tool: None (construct in memory)

Fork Terminal

• Execute: <FORK_TOOL> <constructed_command>
• Reports success or failure
• Example: python3 ${CLAUDE_SKILL_DIR}/scripts/fork_terminal.py claude -p "fix tests" --dangerously-skip-permissions
• Tool: Bash