getting started

Requirements

• macOS 14 or later
• Node on your PATH, for the agent plugins
• Claude Code, Codex or Antigravity, if you want the live status layer. Plain shells work either way; they just appear as basic rows

Install

Download the latest build from the download section, move Fleet.app to /Applications, and open it.

This is the only time you need to do that. Fleet checks for new versions itself and installs them while it runs, handing your open sessions to the new version without closing any — see Configuration for how that works, and for turning it off.

Your first sessions

Fleet opens with a single shell. From there:

• ⌘T opens another shell session
• ⌘⇧T opens an agent session
• ⌃` opens a Quick Terminal — a scratch shell in a drawer, for the one-off command that does not deserve a row of its own
• The sidebar’s ＋ New Session button is a split button — click it for a shell, or use the ▾ menu for an agent session, a specific folder, a saved launch profile, or a new group

Each session gets its own row. Double-click a title to rename it, right-click for colour and group options, and drag rows to reorder them — see Sessions & groups.

Turn on the status layer

Out of the box, agent sessions look like any other shell. To get live status — working, your turn, needs permission, model, context percentage — install the fleet plugin for the agents you use:

Settings (⌘,) → Claude Code integration → Set up Claude Code Integration, and the same in the Codex and Antigravity sections if you have those

This is also offered on the welcome guide, which you can reopen at any time from Help → Welcome to Fleet.

Any Claude session already open needs /reload-plugins before its row starts reporting; sessions you open afterwards are fine. See AI enhancements for what the layer gives you, and Driving Fleet from an agent for what the same plugin lets a session do to Fleet itself.

Then learn one shortcut

⌘⇧J jumps to the next session that needs you, and cycles through them. Instead of watching the sidebar, you press it until nothing is left.

Getting around has the rest.