About FleetCode
FleetCode is an MCP server in the Blockchain category: light-weight control pane to run CLI coding agents(Claude Code, Codex) in parallel.
Install
git clone https://github.com/built-by-as/FleetCodeThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about FleetCode
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
README
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
- 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 <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
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.