Local Mac fleet control for coding agents

Run more agent sessions across your Macs without babysitting SSH.

Fleet auto-picks the healthiest Mac, launches isolated worktrees, keeps remote dev servers reachable through localhost, and gives you a live dashboard for Claude Code and Codex-style workloads.

Download latest release View on GitHub

3/4 · 2 CC

Fleet Dashboard

Machines

machinehealthmemswapagents

localfree45%0.0GB1

mm1busy22%2.1GB2

mm2free57%0.0GB0

Tunnels

localhost:3000 -> mm2:3000 · neonwatty/web-app

localhost:4001 -> mm1:5173 · neonwatty/admin

$ fleet launch neonwatty/my-project

selected mm2 · cloned worktree · tunnel ready · starting claude

Fleet is built for the moment when one Mac is no longer enough for active coding-agent work, but a full cloud scheduler is the wrong shape. Your MacBook stays the control plane. Your Mac minis stay simple SSH targets.

How it works

One command turns spare Macs into usable agent capacity.

Probe the fleet

Fleet checks online status, available memory, swap pressure, and current Claude Code or Codex process counts across configured machines.

Launch on the best target

It creates or updates a bare clone, opens a fresh worktree, and starts the configured command on the chosen Mac.

Keep localhost working

SSH tunnels map remote dev servers back to local ports, including pinned ports for OAuth callbacks that expect localhost.

Fleet terminal dashboard showing machine health, sessions, tunnels, and process groups. — Live terminal dashboard with machine health, tunnel state, and process visibility.

Visibility

Know where every session is running.

Live TUI dashboard

Track machines, sessions, tunnels, and heavyweight process groups from one terminal view.

Native menu bar status

See online machine count, active coding-agent sessions, labels, accounts, swap pressure, and SSH targets from macOS.

Agent-readable JSON

Let Claude Code, Codex, or scripts inspect capacity and choose an SSH target with fleet status --json.

Clean session lifecycle

Worktrees, tunnels, state, labels, and stale sessions are reconciled with fleet clean and fleet doctor.

Fleet menu bar popover showing machine health, swap, active agents, and SSH targets. — Native macOS menu bar popover with live fleet health.

Install

Download the CLI, optionally add the menu bar app.

Fleet targets macOS and uses your existing SSH configuration. Release archives include installer and uninstaller scripts.

tar -xzf fleet_VERSION_darwin_arm64.tar.gz
cd fleet_VERSION_darwin_arm64
scripts/install.sh

fleet init
fleet status

Use cases

For developers turning nearby Macs into practical agent capacity.

Parallel agent work

Start separate sessions across machines without manually checking Activity Monitor or remembering which host is overloaded.

OAuth-heavy web apps

Pin local tunnel ports so callbacks registered to localhost:3000 keep working while the dev server runs remotely.

Menu bar monitoring

Keep fleet status visible while you work in other apps, then open the full dashboard when a machine needs attention.

Agent placement instructions

Expose fleet status --json so coding agents can explain their machine choice before starting long-running work.

Deliberately narrow

Built for local Macs, SSH, and hands-on developer workflows.

No target daemon

Fleet shells out to your system SSH setup. The remote Macs do not need a resident service.

macOS first

The probing, menu bar app, and release artifacts are designed around Apple Silicon Macs.

Transparent state

Config and session state live under ~/.fleet, with dry-run cleanup and doctor commands for inspection.