FleetCode
A desktop terminal application for running multiple CLI coding agents simultaneously, each in isolated git worktrees.
Features
Multiple Sessions : Run multiple coding agent sessions (Claude, Codex) in parallel
: Run multiple coding agent sessions (Claude, Codex) in parallel Git Worktree Isolation : Each session runs in its own git worktree, keeping work isolated
: Each session runs in its own git worktree, keeping work isolated Persistent Sessions : Sessions persist across app restarts with automatic resumption
: Sessions persist across app restarts with automatic resumption Terminal Theming : Choose from preset themes (macOS Light/Dark, Solarized Dark, Dracula, One Dark, GitHub Dark)
: Choose from preset themes (macOS Light/Dark, Solarized Dark, Dracula, One Dark, GitHub Dark) Setup Commands : Configure shell commands to run before the coding agent starts
: Configure shell commands to run before the coding agent starts MCP Server Management : Add and configure Model Context Protocol (MCP) servers
: Add and configure Model Context Protocol (MCP) servers Session Management: Rename, close, and delete sessions with automatic worktree cleanup
Prerequisites
Node.js 16+
Git
Claude CLI ( npm install -g @anthropic-ai/claude-cli ) or Codex
Installation
npm install
Usage
Development
npm run dev
Production Build
npm run build npm start
How It Works
Session Creation
Select a project directory (must be a git repository) Choose a parent branch for the worktree Select your coding agent (Claude or Codex) Optionally add setup commands (e.g., environment variables, source files) FleetCode creates a new git worktree and spawns a terminal session
Session Management
New Sessions : Use --session-id for first-time Claude sessions
: Use for first-time Claude sessions Reopened Sessions : Automatically resume with --resume
: Automatically resume with Worktrees : Each session gets its own isolated git worktree
: Each session gets its own isolated git worktree Persistence: Sessions are saved and can be reopened after closing the app
Terminal Settings
Access settings via the gear icon (⚙️) in the sidebar:
Font Family : Choose from common monospace fonts
: Choose from common monospace fonts Font Size : Adjust terminal text size
: Adjust terminal text size Theme : Select from preset color themes
: Select from preset color themes Cursor Blink: Toggle cursor blinking
MCP Servers
Configure Model Context Protocol servers for enhanced agent capabilities:
stdio : Direct process communication
: Direct process communication SSE: Server-sent events via HTTP
Troubleshooting
macOS: "App can't be opened because it is from an unidentified developer"
If you encounter a quarantine warning when trying to open the app on macOS, run:
xattr -cr /path/to/FleetCode.app
This removes the quarantine attribute that prevents the app from opening.
Claude Code: Working Directory Issues
If you're using Claude Code and it's reading/writing files from the wrong directory instead of the worktree, disable "Auto connect to IDE" in your Claude Code settings:
claude config
Set autoConnectToIde to false . This ensures Claude Code operates within the correct worktree directory.
License
ISC