Installation

Getting set up takes a few minutes: download the app, then make sure the coding agents you want to use are installed. Fletch is a native macOS app — signed, notarized, and self-updating.

Requirements

• macOS 13 or newer. Fletch’s default per-agent isolation uses sandbox-exec, which is macOS-only.
• At least one supported agent CLI, installed and authenticated (for example claude). Fletch can install missing ones for you — see below.
• git. Fletch looks for it on your PATH; if your machine has no usable git at all, Fletch offers to download a verified portable build and use that instead.

Docker is not required. The default sandbox is native macOS Seatbelt; Docker is an optional second engine for container-level isolation — see Security & Sandboxing. GitHub features (cloning, creating repos, pull requests) use a built-in GitHub connection you authorize in the app; there is no GitHub CLI to install.

Download

Download Fletch for macOS → — a universal build for Apple Silicon and Intel.

Install your agents

Fletch drives the agent CLIs you already use and pay for; it doesn’t ship a model of its own. Install and sign in to the ones you want:

• Claude Code (the default)
• Codex
• Cursor Agent
• OpenCode
• Pi (experimental)
• Antigravity (experimental)

Fletch finds each CLI automatically — even when it’s installed somewhere your shell’s PATH doesn’t include. For an agent that isn’t installed yet, Fletch offers a one-click Install (running the vendor’s official installer, with progress streamed live) where the CLI supports scripted install — Claude Code, Codex, Cursor Agent, and OpenCode — and a link to the vendor’s instructions otherwise. If a binary lives somewhere unusual, set an explicit path under Settings › Providers.

Where Fletch looks

Beyond your PATH and login-shell PATH, it checks common install locations like ~/.local/bin, ~/.npm-global/bin, ~/.bun/bin, /opt/homebrew/bin, and /usr/local/bin.

Tip

You only need one agent to get started. You can enable, disable, and re-scan for the rest at any time in Settings › Providers.

First run

1. Fletch walks you through a short onboarding: an optional sign-in, a check for git, an optional GitHub connection, and agent CLI detection. Every step except git can be skipped and finished later.
2. Add a project — see Your First Repository.
3. Spawn an agent with a task — see Your First Agent.

Related docs

• Your First Repository
• Your First Agent
• Updates