Docs
Everything Fleet does, and what it deliberately does not do. If you have not used git worktrees or a coding agent before, start with Learn instead: it teaches the ideas these pages assume.
Start here
- Getting startedInstall Fleet, point it at a repository, and get an agent working on a branch of its own in about five minutes.
- RequirementsmacOS on Apple silicon, git, your own authenticated Claude Code, and the GitHub CLI if you want pull requests.
- Your first sessionWhat actually happens between pressing Send and having a branch you can review, step by step.
Sessions
- Worktrees and branchesEvery session gets a real checkout of its own, branched from origin, so agents never share a working directory.
- Permissions and modesFour modes, and the line Auto holds is containment rather than tool type. Only you may ever approve a plan or answer a question.
- PlansA proposed plan is a document, so it gets a column of its own rather than a box at the tail of the chat.
- Review and mergeRead the diff, leave notes anchored to lines, send them back as one prompt, then merge or open a pull request.
- CheckpointsA snapshot before every turn, kept off your branch entirely. Restoring files is clean; rewinding the conversation starts a fresh Claude session.
- Terminals and run scriptsNamed scripts per repository, a real shell in the worktree, and a deterministic block of ten ports per session so four dev servers do not collide.
Squads
- Squads overviewOne orchestrator that is itself an agent, driving several worker agents in their own worktrees, delivering one branch and one pull request.
- The orchestratorWhat the orchestrator can actually do: spawn, brief, wait, review, merge, ask you, and deliver.
- Rounds and pull requestsOne round is one feature: one integration branch, one pull request. Opening it seals the round, and the next prompt is a decision before it is a task.
- RolesThe editable half of a squad member's system prompt. Fleet owns the wiring, you own the working style.
Projects
Reference
- MCP serversAn MCP server is a command Fleet will run, so where the definition came from is part of the definition. Repo-declared servers arrive disabled.
- Usage and costA local ledger of one row per turn, so Fleet can answer what you spent on which model, in which repo, on what.
- Settings and themesWhat you can change, what a repository can change on your behalf, and why every accent is a shade of blue.
- Keyboard shortcutsEvery binding in Fleet, and why none of them is a bare letter.
- TroubleshootingThe failures that have real causes: PATH, a worktree deleted in Finder, a merge that refuses, a port that will not free, a sealed round.