Install Fleetctl
One command, prebuilt binary, under a minute. You will need an active Fleet trial or subscription before it can start hosted workflows.
Let your AI install Fleet
If you use Claude Code, Codex, OpenCode, or any assistant that reads SKILL.md — install the fleet-setup skill once and then just tell it to set Fleet up. It walks you through prerequisites, the install, registration, sign-in, fleet up, and skills install.
Install the skill
One-time install. Uses npx skills to clone the skill from our public repo and drop it into your agent's skill directory.
npx skills add Feral-Intelligence/agent-skills --skill fleet-setupAsk your AI assistant
Open any repo you want Fleet to manage and send your agent a plain-English request. It handles the rest: OS detection, binary install, license registration prompt, project init, and picking the right first agent.
“Set up Fleet in this repo”
You still need an active trial or subscription. The skill prompts for a registration code from the dashboard and will not proceed without one.
Then let your AI run the fleet
Once Fleet is set up, add the fleet-manager skill. Your assistant becomes the operator of your agent team: it scopes requests into tickets, selects the right saved workflow, and follows its governed run to a reviewed, approved merge instead of writing the code itself.
npx skills add Feral-Intelligence/agent-skills --skill fleet-manager“Manage my fleet”
Then keep what the team learns
fleet-lessons is the governed Learning contract. After install, fleet skills install and the Fleet Codex plugin both include it, so the assistant loads signed policy before work and turns corrections into human-approved Lessons instead of one-off prompt edits.
fleet skills install“Remember this as a Lesson”
Install Fleet manually
One command. Downloads a prebuilt binary, verifies its SHA-256, and installs it to ~/.local/bin/fleet. No Go toolchain, no source build, no repository access required.
Install Fleet
Runs the installer at fleetctl.ai/install. It detects your OS and architecture, fetches the latest version from /releases/latest, downloads the matching prebuilt binary, verifies the SHA-256 against the published SHA256SUMS, and installs to ~/.local/bin/fleet. Supported: macOS and Linux on x86_64 and arm64. This is the official Fleetctl CLI. The npm package named fleetctl is a different product (FleetDM at fleetdm.com); Fleetctl is not published on npm, PyPI, or Homebrew.
curl -fsSL https://fleetctl.ai/install | shfleet versionConnect Fleet to your account
Fleet will refuse to start agents, the brain daemon, or the watcher until this step succeeds. Generate a registration code in your Fleet dashboard, then paste it here. Run fleet login afterward so hosted workflows and Lessons use your human identity.
fleet admin register --url https://app.fleetctl.ai --code YOUR_REGISTRATION_CODEfleet loginfleet admin statusfleet auth statusBring the repository up
Run inside any git repository you want Fleet to manage. fleet up scaffolds .fleet/config.yaml if needed, starts the watcher, and starts the brain. Then install the skills that ship with this binary.
cd /path/to/your/projectfleet upfleet skills installfleet agent listfleet statusWhat happens without a license
The binary is free to install and inspect. New hosted workflow starts require a registered, active trial or paid subscription.
License-gated commands
Any command that starts an agent, spins up a daemon, or runs a hosted workflow calls the entitlement gate first. An unregistered, expired, or exhausted trial produces a clear error with the exact command to fix it.
Commands that work without a license
Diagnostic and read-only commands always work so you can install, inspect, and register the binary without a chicken-and-egg problem.
Verify your install
Run these commands after installation to confirm everything is wired up.
Health check
fleet doctor audits every dependency and reports which are OK, missing, or misconfigured.
fleet doctorSystem requirements
Fleet needs these tools on your machine before it can run.
tmux
RequiredFleet manages each agent in its own tmux session. Install via your package manager: brew install tmux (macOS) or apt install tmux (Debian/Ubuntu).
gh CLI
RecommendedThe GitHub CLI (cli.github.com) is used by the brain daemon to poll PRs, reviews, CI checks, and issues. Run 'gh auth login' once to authenticate.
Active Fleet entitlement
RequiredNew hosted workflows require an active trial or paid subscription. Generate a registration code in the Fleet dashboard, then run 'fleet admin register'.
Need a registration code?
Start free and generate a registration code in the dashboard. Free includes 500 hosted starts. A start counts at durable first-step authorization even if the workflow later fails; internal steps and same-run retries or resumes do not add usage. Model-provider fees are separate.