# fork-terminal

> 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.

- Author: Emanual Jade
- Repository: emanualjade/vibe-coding-resources
- Version: 20251229154542
- Stars: 0
- Forks: 0
- Last Updated: 2026-02-07
- Source: https://github.com/emanualjade/vibe-coding-resources
- Web: https://mule.run/skillshub/@@emanualjade/vibe-coding-resources~fork-terminal:20251229154542

---

---
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 <xyz> summarizing our conversation so far"
  - "Spin up a new terminal to <xyz> with gemini cli agent summarizing our conversation so far"
  - "Create a new terminal to <xyz> 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 <xyz> with ffmpeg"
  - "Create a new terminal to <xyz> with curl"
  - "Create a new terminal to <xyz> 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 <xyz> with claude code"
  - "Create a new terminal to <xyz> using claude"
  - "Spin up a new terminal to <xyz> 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 <xyz> with gemini cli"
  - "Create a new terminal to <xyz> using gemini cli"
  - "Spin up a new terminal to <xyz> 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 <xyz> with codex cli"
  - "Create a new terminal to <xyz> using codex cli"
  - "Spin up a new terminal to <xyz> with codex cli agent"