forked fleetcode to make it remote first
Find a file
Anish Lakhwara f75c054e65 update
2025-11-08 21:58:34 -08:00
.beads update 2025-11-08 21:58:34 -08:00
.github/workflows Add automatic release notes to workflow 2025-10-10 20:41:34 -04:00
build icons 2025-10-04 20:36:20 -04:00
.gitattributes update 2025-11-08 21:58:34 -08:00
.gitignore ignore fleetcode directory 2025-10-03 15:12:46 -04:00
.nixos-patch-electron.sh Add Nix flake, development scripts, and web server setup documentation 2025-10-11 16:57:37 -07:00
AMP_INTEGRATION.md Add Nix flake, development scripts, and web server setup documentation 2025-10-11 16:57:37 -07:00
dev.sh Add Nix flake, development scripts, and web server setup documentation 2025-10-11 16:57:37 -07:00
DIFF_VIEWER_IMPLEMENTATION.md diff viewer 2025-11-08 00:33:44 -08:00
flake.lock update 2025-11-08 21:58:34 -08:00
flake.nix update 2025-11-08 21:58:34 -08:00
fleetcode.png add image to readme 2025-10-03 17:13:55 -04:00
index.html update 2025-11-08 21:58:34 -08:00
ipc-adapter.ts Add Nix flake, development scripts, and web server setup documentation 2025-10-11 16:57:37 -07:00
main.ts Add Nix flake, development scripts, and web server setup documentation 2025-10-11 16:57:37 -07:00
NIX_SETUP.md Add Nix flake, development scripts, and web server setup documentation 2025-10-11 16:57:37 -07:00
nodemon.json Add Nix flake, development scripts, and web server setup documentation 2025-10-11 16:57:37 -07:00
package-lock.json diff viewer 2025-11-08 00:33:44 -08:00
package.json diff viewer 2025-11-08 00:33:44 -08:00
README.md Add Nix flake, development scripts, and web server setup documentation 2025-10-11 16:57:37 -07:00
renderer.ts update 2025-11-08 21:58:34 -08:00
server.ts update 2025-11-08 21:58:34 -08:00
simple-claude.ts add mcp server working 2025-10-03 00:25:36 -04:00
START_SERVER.md Add Nix flake, development scripts, and web server setup documentation 2025-10-11 16:57:37 -07:00
styles.css update 2025-11-08 21:58:34 -08:00
tailwind.config.js sidebar 2025-10-02 13:16:38 -04:00
terminal-utils.ts Improve unread indicator detection 2025-10-10 19:39:50 -04:00
tsconfig.json typescript 2025-10-02 13:03:09 -04:00
types.ts update 2025-11-08 21:58:34 -08:00
WEB_SERVER_SETUP.md Add Nix flake, development scripts, and web server setup documentation 2025-10-11 16:57:37 -07:00

FleetCode

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

  1. Select a project directory (must be a git repository)
  2. Choose a parent branch for the worktree
  3. Select your coding agent (Claude, Codex, or Amp)
  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