--- name: fork-terminal 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: ' or 'fork session: '. --- # 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. - All file paths below are relative to the skill's base directory (shown above as "Base directory for this skill"). ### 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 `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 and sections. - EXAMPLES: - "fork terminal use claude code to summarize work so far" - "spin up a new terminal request using claude code include summary" - "create a new terminal to with claude code with summary" ## Workflow 1. Understand the user's request. 2. READ: `tools\/fork_terminal.py` to understand our tooling. 3. Follow the `Cookbook` to determine which tool to use. 4. Execute the `tools\/fork_terminal.py` script with the command. ## Cookbook ### Raw CLI Commands - IF: The user requests a non-agentic coding tool AND `ENABLE_RAW_CLI_COMMANDS` is true. - THEN: Read and execute: `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 - IF: The user requests a claude code agent to execute the command AND `ENABLE_CLAUDE_CODE` is true. - THEN: Read and execute: `cookbook\/claude-code.md` - EXAMPLES: - "fork terminal use claude code to " - "spin up a new terminal request using claude code" - "create a new terminal to 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: `cookbook\/codex-cli.md` - EXAMPLES: - "fork terminal use codex to " - "spin up a new terminal request using codex" - "create a new terminal to 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: `cookbook\/gemini-cli.md` - EXAMPLES: - "fork terminal use gemini to " - "spin up a new terminal request with gemini" - "create a new terminal to using gemini"