forked fleetcode to make it remote first
Find a file
2025-10-06 20:46:04 -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 Add custom branch name feature 2025-10-05 17:09:48 -04:00
main.ts Start MCP poller immediately when session starts 2025-10-06 20:46:04 -04:00
package-lock.json Upgrade to @xterm/addon-fit from xterm-addon-fit 2025-10-05 21:12:37 -04:00
package.json Upgrade to @xterm/addon-fit from xterm-addon-fit 2025-10-05 21:12:37 -04:00
README.md add image to readme 2025-10-03 17:13:55 -04:00
renderer.ts Clear MCP sidebar when switching between sessions 2025-10-06 18:38:26 -04:00
simple-claude.ts add mcp server working 2025-10-03 00:25:36 -04:00
styles.css Fix session name truncation to prevent overlap with close button 2025-10-06 18:24:38 -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
types.ts resizing works, delete git branch when deleting session 2025-10-06 18:05:14 -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