fleetcode/README.md
Amrit Subramanian 8b18f47902 Add Claude Code auto-connect troubleshooting section
Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-07 11:20:30 -04:00

102 lines
2.8 KiB
Markdown

# FleetCode
![FleetCode](fleetcode.png)
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
```bash
npm install
```
## Usage
### Development
```bash
npm run dev
```
### Production Build
```bash
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
## 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:
```bash
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:
```bash
claude config
```
Set `autoConnectToIde` to `false`. This ensures Claude Code operates within the correct worktree directory.
## License
ISC