Ccfleet — Development skill for Claude Code

ccfleet

**A web dashboard for centrally managing Claude Code remote-control sessions. Start and stop Claude Code processes from a browser, then connect to them from the Claude Code desktop, mobile, or web app.**

**SECURITY:** ccfleet has no built-in authentication. Access control is provided by Cloudflare Access (JumpCloud SAML) when accessed remotely, and by network trust on the local LAN. Never expose port `3001` directly to the public internet. See [`SECURITY.md`](SECURITY.md).

Quick Start

**Prerequisites:** Node.js 20+, `tmux`, `claude` CLI, and a populated `~/git/` directory of repositories.

**Option A — Docker (Linux only)**

Docker requires a Linux host. On macOS the container runs inside a VM that cannot reach the host tmux server or the host `claude` binary, so sessions will not work. Use Option B or C on macOS.

git clone 
cd ccfleet
cp .env.example .env   # fill in GIT_ROOT at minimum
docker compose up -d

**Option B — Node directly (foreground)**

git clone 
cd ccfleet
npm ci --omit=dev
cp .env.example .env   # fill in GIT_ROOT at minimum
npm test               # 86/86 should pass
npm start

Open `http://:3001`.

**Option C — Boot-time service (macOS or Linux)**

This is the recommended path for a machine you SSH into. The service starts before any user logs in and restarts automatically if it crashes.

*macOS (launchd):*

git clone 
cd ccfleet
cp .env.example .env   # fill in GIT_ROOT at minimum
sudo bash scripts/install-launchd.sh

The script installs both ccfleet and ttyd as LaunchDaemons under `/Library/LaunchDaemons/`. Dependencies (`node_modules`) are installed automatically if missing. Logs land in `~/Library/Logs/ccfleet/`.

# Verify it started
curl http://localhost:3001/readyz          # {"status":"ok"}
launchctl list | grep ccfleet             # both services listed