Control Claude Code from anywhere. Answer prompts from your phone while Claude runs on your desktop.

Crabigator is a terminal wrapper that runs Claude Code (or Codex CLI) with real-time status widgets and remote control from your phone. Claude runs natively on your machine exactly as intended, while Crabigator streams the session to a web dashboard where you can:

• Answer permission requests — Approve file writes, command execution, and tool use from anywhere
• Respond to questions — When Claude asks for clarification, reply from your phone
• Monitor progress — Watch Claude think, see what files it's reading, track token usage
• Stay in the loop — Get notified when Claude needs your input

npm install -g crabigator

git clone https://github.com/samuelclay/crabigator.git
cd crabigator
cargo install --path .

• Claude Code or Codex CLI installed and authenticated
• Node.js 18+ (for npm install) or Rust 1.70+ (for cargo install)
• macOS, Linux, or Windows (WSL)

# Run with Claude Code (default)
crabigator

# Or explicitly specify the platform
crabigator claude
crabigator codex

The first time you run Crabigator, it will prompt you to pair with your phone:

1. A pairing code appears in your terminal (e.g., ABC-DEF-GHI)
2. Open drinkcrabigator.com/dashboard on your phone
3. Enter the pairing code to connect

Once paired, your sessions automatically stream to the dashboard.

Answer Claude's prompts from your phone when you're away from your desk. Permission requests, questions, and plan approvals all work remotely.

Real-time widgets below Claude's interface show:

• Session stats — Time elapsed, prompts sent, tokens used
• Git status — Modified, added, and deleted files
• Semantic diff — Changes organized by functions and classes

• Claude Code runs in a PTY exactly as normal
• Full scrollback history preserved
• Native text selection and clipboard
• All keyboard shortcuts work (Option+Arrow, etc.)

Supports both Claude Code (Anthropic) and Codex CLI (OpenAI).

┌─────────────────────────────────────┐
│                                     │
│         Claude Code (PTY)           │  ← Runs exactly as normal
│                                     │
├─────────────────────────────────────┤
│ Stats │ Git Status │ File Changes   │  ← Status widgets
└─────────────────────────────────────┘
                │
                ▼
        ┌───────────────┐
        │  Cloud Relay  │  ← Streams to drinkcrabigator.com
        └───────────────┘
                │
                ▼
        ┌───────────────┐
        │ Your Phone    │  ← Answer prompts remotely
        └───────────────┘

Crabigator spawns Claude Code in a pseudo-terminal and uses ANSI scroll region escape sequences to confine its output to the top portion of your terminal. Status widgets render below using raw escape codes. Session state streams to Cloudflare Workers via WebSocket for the mobile dashboard.

The codebase is organized into focused modules:

crabigator              # Start with default platform (Claude Code)
crabigator claude       # Use Claude Code explicitly
crabigator codex        # Use Codex CLI
crabigator pair         # Generate a new pairing code
crabigator inspect      # View other running instances
crabigator --help       # Show all options

Each session creates /tmp/crabigator-{session_id}/ containing:

• scrollback.log — Clean text transcript (ANSI stripped)
• screen.txt — Current screen snapshot
• mirror.json — Widget state for external tools

Crabigator stores preferences in ~/.crabigator/config.toml:

platform = "claude"  # or "codex"

Claude Code hooks are installed to ~/.claude/crabigator/ for tracking session state and statistics.

It's a quadruple wordplay:

• Claude — The AI we're wrapping
• Navigator — It navigates and controls your Claude Code sessions
• Crab — Rust's mascot is Ferris the crab
• Alligator — Named after the late Claude, the beloved albino alligator at the California Academy of Sciences

Contributions welcome! Please feel free to submit a Pull Request.

# Development
cargo build              # Debug build
cargo build --release    # Release build
cargo test               # Run tests
cargo clippy             # Lint

# Cloud development
cd workers/crabigator-api
npm run dev              # Local dev server

MIT License - see LICENSE for details.

drinkcrabigator.com · Report a Bug · Request a Feature