claude-session-fork

中文文档

Fork Claude Code sessions at any conversation point and continue in a new terminal.

Features

• 🔀 Fork at any point - Select any message to create a branch from
• 📜 Session browser - Browse all sessions with preview
• 📝 Visual history - Browse conversation with code change indicators (◆)
• 🖥️ Multi-terminal - Supports Terminal.app, iTerm2, VS Code, Cursor, Kiro
• ⚡ Auto-detect - Automatically uses current session in Claude Code

Installation

npm (Recommended)

npm install -g claude-session-fork

Homebrew (macOS)

brew tap duo121/claude-session-fork
brew install claude-session-fork

From source

git clone https://github.com/duo121/claude-session-fork.git
cd claude-session-fork
npm install && npm run build && npm link

Uninstall

npm

npm uninstall -g claude-session-fork

Homebrew

brew uninstall claude-session-fork
brew untap duo121/claude-session-fork

From source

npm unlink -g claude-session-fork

Usage

# Fork current session (auto-detect in Claude Code)
sfork

# Show session list to choose from
sfork --list
sfork -l

# Fork specific session
sfork --session=<session-id>

# Specify terminal
sfork --terminal=iterm
sfork --terminal=vscode

Commands: sfork, csfork, claude-session-fork

Workflow

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│  Session List   │ ──► │  Message List   │ ──► │  New Terminal   │
│  (--list mode)  │     │  (select fork   │     │  (forked        │
│                 │     │   point)        │     │   session)      │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                       │
        │ Esc                   │ Esc
        ▼                       ▼
      Exit                Back to Sessions

Controls

Session List (--list mode)

| Key | Action | |-----|--------| | ↑↓ | Navigate sessions | | Enter | Select session | | Esc | Exit |

Message List

| Key | Action | |-----|--------| | ↑↓ | Navigate messages | | +/- | Expand/collapse preview (1-10 lines) | | Space | Toggle user-only filter | | Enter | Fork at selected point | | Esc | Back (list mode) / Exit |

Command Line Options

sfork                      # Fork current session
sfork --list, -l           # Show session list
sfork --session=<id>       # Fork specific session
sfork --cwd=<path>         # Specify working directory
sfork --terminal=<type>    # Terminal: auto, iterm, terminal, vscode, cursor, kiro
sfork --help, -h           # Show help
sfork --version, -v        # Show version

How It Works

┌─────────────────────────────────────────────────────────────┐
│                    Original Session                          │
├─────────────────────────────────────────────────────────────┤
│  [0] You: "Help me build a REST API"                        │
│  [1] Claude: "I'll help you create a REST API..."           │
│  [2] You: "Add authentication"         ◄── Fork Point       │
│  [3] Claude: "Let's add JWT authentication..."              │
└─────────────────────────────────────────────────────────────┘
                           │
                           ▼ sfork (select message 2)
                           │
        ┌──────────────────┴──────────────────┐
        ▼                                      ▼
┌───────────────────┐                ┌───────────────────┐
│  Original Window  │                │   New Terminal    │
│  (continues)      │                │  (forked from     │
│                   │                │   message 2)      │
└───────────────────┘                └───────────────────┘

Requirements

• macOS (uses AppleScript for terminal control)
• Claude Code CLI
• Node.js 18+

Documentation

https://claude-session-fork.vercel.app

License

MIT