Amp-Thread-ID: https://ampcode.com/threads/T-a6cf4bd2-36d0-4ef8-ada6-a8e2850fcacf Co-authored-by: Amp <amp@ampcode.com>
2.8 KiB
2.8 KiB
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, Amp) 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), Codex, or Amp
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, Codex, or Amp)
- 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
