fork-terminal-skill

name	Fork Terminal Skill
description	Fork a terminal session to a new terminal window. Use this when the user requests 'fork terminal' or 'create a new terminal' or 'new terminal: <command>'.

Purpose

Fork a terminal session to a new terminal window Using one agentic coding tool or raw cli commands. Follow the Instructions, execute the Workflow, and refer to the Cookbook for decision-making.

Variables

ENABLED_RAW_CLI_COMMANDS: true ENABLED_GEMINI_CLI: true ENABLED_CODEX_CLI: true ENABLED_CLAUDE_CODE_CLI: true AGENTIC_CODING_TOOLS: claude-code, gemini-cli, codex-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 User Request section.
  • This will be what you pass into the prompt parameter for the agentic coding tool.
  • IMPORTANT: To be clear, don't update the file directly, just use it as your prompt when creating the agent.
• EXAMPLES:
  • "Fork terminal use claude code to summarizing our conversation so far"
  • "Spin up a new terminal to with gemini cli agent summarizing our conversation so far"
  • "Create a new terminal to with codex cli agent 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 using: uv run .claude/skills/fork-terminal/tools/fork_terminal.py '<command>'
   • Always use uv run, never python3 directly (requires Python 3.10+ for type union syntax)

Cookbook

If the request is for an agent you should follow the agent specific instructions even if we are requesting the agent to do a simple CLI command. For example, if the user requests "Create a new terminal to download a file with curl using claude code" you should follow the Claude Code Agent instructions.

Raw CLI Commands

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

Claude Code Agent

• IF: the user requests a claude code agent AND ENABLED_CLAUDE_CODE_CLI is true.
• THEN: Read and execute: .claude/skills/fork-terminal/cookbook/claude-code.md
• EXAMPLES:
  • "Fork terminal to with claude code"
  • "Create a new terminal to using claude"
  • "Spin up a new terminal to with claude agent"

Gemini CLI Agent

• IF: the user requests a gemini cli agent AND ENABLED_GEMINI_CLI is true.
• THEN: Read and execute: .claude/skills/fork-terminal/cookbook/gemini-cli.md
• EXAMPLES:
  • "Fork terminal to with gemini cli"
  • "Create a new terminal to using gemini cli"
  • "Spin up a new terminal to with gemini cli agent"

Codex CLI Agent

• IF: the user requests a codex cli agent AND ENABLED_CODEX_CLI is true.
• THEN: Read and execute: .claude/skills/fork-terminal/cookbook/codex-cli.md
• EXAMPLES:
  • "Fork terminal to with codex cli"
  • "Create a new terminal to using codex cli"
  • "Spin up a new terminal to with codex cli agent"