▍fleet
Getting Started

Requirements

What fleet needs to run.

Required

  • macOS or Linux
  • tmux — brew install tmux / apt install tmux. On Linux, tmux ≥ 3.3 is recommended (terminal passthrough); older versions work with that feature disabled.
  • Claude Code — claude on your $PATH

Optional

  • gh — required for PR badges (CI status, reviews, unresolved threads). PR info is hidden if gh isn't installed.
  • Google Chrome — required for the p-to-open-PR tab-reuse feature. Falls back to open <url> / xdg-open <url> if Chrome or the extension isn't available.
  • Linux clipboard tool — wl-clipboard, xclip, or xsel routes tmux copy-mode selections to the system clipboard; without one, fleet falls back to OSC 52.

Permissions

  • fleet writes to ~/.config/fleet/ (state DB, hook status files, debug log)
  • The Chrome extension installs a Native Messaging Host manifest under ~/Library/Application Support/Google/Chrome/NativeMessagingHosts/ (macOS) or ~/.config/google-chrome/NativeMessagingHosts/ (Linux) — also installed into ~/.config/chromium/ and the beta/unstable config dirs when present
  • Hooks are auto-installed into ~/.claude/settings.json on first launch

Nothing leaves your machine.

Quick Start

Launch fleet and run your first parallel Claude Code sessions.

Keybindings

The full keybinding reference for the fleet TUI.

On this page

RequiredOptionalPermissions