Fork Terminal Skill

Purpose

Fork a terminal session to a new terminal window. Using one agentic coding tools or raw cli commands. Follow the Instructions, execute the Workflow, based on the Cookbook.

Variables

ENABLE_RAW_CLI_COMMANDS: true ENABLE_GEMINI_CLI: true ENABLE_CODEX_CLI: true ENABLE_CLAUDE_CODE: true AGENTIC_CODING_TOOLS: claude-code, codex-cli, gemini-cli

Instructions

• Based on the user's request, follow the Cookbook to determine which tool to use.

Fork Summary User Prompts

• IF: The user requests a fork terminal with a summary. This ONLY works for our agentic coding tools AGENTIC_CODING_TOOLS. The tool MUST BE enabled as well.
• THEN:
  • Read, and REPLACE the .claude/​skills/​fork-terminal/​prompts/​fork_summary_user_prompt.md with the history of the conversation between you and the user so far.
  • Include the next users request in the Next User Request section.
  • This will be what you pass into the PROMPT parameter of the agentic coding tool.
  • IMPORTANT: To be clear, don't update the file directly, just read it, fill it out IN YOUR MEMORY and use it to craft a new prompt in the structure provided for the new fork agent.
  • Let's be super clear here, the fork_summary_user_prompt.md is a template for you to fill out IN YOUR MEMORY. Once you've filled it out, pass that prompt to the agentic coding tool.
  • XML Tags have been added to let you know exactly what you need to replace. You'll be replacing the <fill in the history here> and <fill in the next user request here> sections.
• EXAMPLES:
  • "fork terminal use claude code to <xyz> summarize work so far"
  • "spin up a new terminal request <xyz> using claude code include summary"
  • "create a new terminal to <xyz> with claude code with summary"

Workflow

1. Understand the user's request.
2. READ: .claude/​skills/​fork-terminal/​tools/​fork_terminal.py to understand our tooling.
3. Follow the Cookbook to determine which tool to use.
4. Execute the .claude/​skills/​fork-terminal/​tools/​fork_terminal.py: fork_terminal(command: str) tool.

Cookbook

Raw CLI Commands

• IF: The user requests a non-agentic coding tool AND ENABLE_RAW_CLI_COMMANDS is true.
• THEN: Read and execute: .claude/​skills/​fork-terminal/​cookbook/​cli-command.md
• EXAMPLES:
  • "Create a new terminal to <xyz> with ffmpeg"
  • "Create a new terminal to <xyz> with curl"
  • "Create a new terminal to <xyz> with python"

Claude Code

• IF: The user requests a claude code agent to execute the command AND ENABLE_CLAUDE_CODE is true.
• THEN: Read and execute: .claude/​skills/​fork-terminal/​cookbook/​claude-code.md
• EXAMPLES:
  • "fork terminal use claude code to <xyz>"
  • "spin up a new terminal request <xyz> using claude code"
  • "create a new terminal to <xyz> with claude code"

Codex CLI

• IF: The user requests a codex CLI agent to execute the command AND ENABLE_CODEX_CLI is true.
• THEN: Read and execute: .claude/​skills/​fork-terminal/​cookbook/​codex-cli.md
• EXAMPLES:
  • "fork terminal use codex to <xyz>"
  • "spin up a new terminal request <xyz> using codex"
  • "create a new terminal to <xyz> with codex"

Gemini CLI

• IF: The user requests a gemini CLI agent to execute the command AND ENABLE_GEMINI_CLI is true.
• THEN: Read and execute: .claude/​skills/​fork-terminal/​cookbook/​gemini-cli.md
• EXAMPLES:
  • "fork terminal use gemini to <xyz>"
  • "spin up a new terminal request <xyz> with gemini"
  • "create a new terminal to <xyz> using gemini"