@fleet-command-agents/cli
v1.0.8
Published
Public installer for Fleet Command: Agents — wire Claude Code, Codex, Cursor & Antigravity into the fleet layer above your coding agents: every session, every machine, one live space map on iPhone & Apple Watch. Each platform pairs as its own fleet. Thin
Maintainers
Readme
@fleet-command-agents/cli (public installer)
The public npm entry point for Fleet Command: Agents — the fleet layer above your coding agents: every Claude Code, Codex, Cursor & Antigravity session, on every machine, rolled into one live map on your iPhone & Apple Watch. Each platform pairs as its own fleet.
This package is a thin delegate. It contains no backend URL, no hook runtime, and no native dependencies. Its only job is to locate the real Fleet Commander runtime (which ships with the Claude Code marketplace plugin) and hand off to it.
Usage — version-pinned only
Always pin a version. Never run @latest (npx caches aggressively, and
pinning is a supply-chain hygiene baseline):
# Codex / Cursor / Antigravity — each pairs as its own fleet
npx -y @fleet-command-agents/cli@<version> setup --agent codex --code FLEET-XXXX
npx -y @fleet-command-agents/cli@<version> setup --agent cursor --code FLEET-XXXX
npx -y @fleet-command-agents/cli@<version> setup --agent antigravity --code FLEET-XXXXThe pairing code (FLEET-XXXX) comes from the iPhone app's Add fleet screen. After
wiring: Codex needs /hooks approval inside Codex; Cursor / Antigravity need an app
restart to load the hooks. (Cursor & Antigravity are observe-only today.)
Claude Code
Claude Code installs via the Claude Code marketplace, not this CLI:
claude plugin marketplace add sideffect263/fleet-commander
claude plugin install fleet-commanderThen pair inside Claude Code: /fleet-link FLEET-XXXX.
How the delegate works
- If the marketplace plugin's stable runtime is already present at
~/.fleet-commander/scripts/fleet.mjs, this CLI spawns it directly. - Otherwise it makes a best-effort, one-time fetch of the pinned runtime
tarball from the published GitHub release of
sideffect263/fleet-commander. - If neither works, it fails honestly with the exact commands to install the Claude marketplace plugin first (which lays down the runtime), then re-run. It never half-wires an agent.
Relationship to the private plugin
The real onboarding logic — hook wiring, pairing, the backend URL, and the
ask_human MCP server — lives in the private package @fleet-commander/plugin,
which is marked private and is never published to npm. This public package
deliberately holds none of those internals.
License
MIT
