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
• Git Worktree Isolation: Each session runs in its own git worktree, keeping work isolated
• Persistent Sessions: Sessions persist across app restarts with automatic resumption
• Terminal Theming: 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
• MCP Server Management: 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

1. Select a project directory (must be a git repository)
2. Choose a parent branch for the worktree
3. Select your coding agent (Claude or Codex)
4. Optionally add setup commands (e.g., environment variables, source files)
5. FleetCode creates a new git worktree and spawns a terminal session

Session Management

• New Sessions: Use --session-id <uuid> for first-time Claude sessions
• Reopened Sessions: Automatically resume with --resume <uuid>
• Worktrees: 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
• Font Size: Adjust terminal text size
• Theme: 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
• 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