forked fleetcode to make it remote first
Find a file
Amrit Subramanian 639ec0ab08 Add per-project MCP configuration support
- Extract MCP servers from ~/.claude.json for each project
- Write project MCP config to .fleetcode/mcp-config-<hash>.json
- Pass --mcp-config flag to Claude CLI on session start
- Update MCP poller to run in project directory instead of worktree
- Reduce first poll delay from 2s to 500ms for faster UI updates
- Add unique UUID suffix to git branch names to prevent conflicts
- Store mcpConfigPath in persisted sessions
2025-10-05 16:01:59 -04:00
.github/workflows use electron builder publishing 2025-10-04 20:57:48 -04:00
build icons 2025-10-04 20:36:20 -04:00
.gitignore ignore fleetcode directory 2025-10-03 15:12:46 -04:00
fleetcode.png add image to readme 2025-10-03 17:13:55 -04:00
index.html Implement per-session MCP server polling with headless PTY 2025-10-05 13:47:37 -04:00
main.ts Add per-project MCP configuration support 2025-10-05 16:01:59 -04:00
package-lock.json github workflow to publish executable 2025-10-03 17:16:48 -04:00
package.json Bump version to 1.0.1-beta.1 2025-10-04 23:03:56 -04:00
README.md add image to readme 2025-10-03 17:13:55 -04:00
renderer.ts Implement per-session MCP server polling with headless PTY 2025-10-05 13:47:37 -04:00
simple-claude.ts add mcp server working 2025-10-03 00:25:36 -04:00
styles.css Add login shell support, session creation loading state, and refactoring 2025-10-04 22:49:33 -04:00
tailwind.config.js sidebar 2025-10-02 13:16:38 -04:00
tsconfig.json typescript 2025-10-02 13:03:09 -04: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) 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

Project Structure

FleetCode/
├── main.ts          # Main Electron process (PTY management, git operations)
├── renderer.ts      # Renderer process (UI, terminal instances)
├── index.html       # Application layout
├── styles.css       # Tailwind CSS styles
└── dist/            # Compiled output

Technology Stack

  • Electron: Desktop application framework
  • xterm.js: Terminal emulator
  • node-pty: PTY (pseudo-terminal) spawning
  • simple-git: Git operations (worktree management)
  • electron-store: Persistent configuration storage
  • Tailwind CSS: Styling

License

ISC