Requirements
Section titled “Requirements”- macOS 14 or newer on a Metal-capable Mac.
- Git available in your login-shell
PATH. - At least one supported coding-agent CLI if you want to run an agent.
Git-backed projects also benefit from a forge CLI:
- Install and authenticate
ghfor GitHub pull requests, checks, and reviews. - Install and authenticate
glabfor GitLab merge requests, pipelines, and reviews.
The app detects local commands through your login shell, so a tool that works only in a differently configured shell may appear unavailable.
Download and launch
Section titled “Download and launch”Download for macOS, open the disk image, and drag the app into Applications. Launch it from Applications so macOS treats future updates consistently.
On first launch, macOS may ask whether to open an app downloaded from the internet. Confirm the prompt. The app may also request notification permission when you enable system notifications.
Prepare an agent CLI
Section titled “Prepare an agent CLI”Install and authenticate the provider’s CLI before selecting it in the app. A useful check is to start the command in a normal terminal and confirm that it can open an authenticated session.
The app can use providers such as Claude Code, Codex, Cursor, OpenCode, Pi, Oh My Pi, Grok, Kimi Code, Copilot, Factory Droid, Kiro, Qwen Code, Hermes, Antigravity, and the legacy Gemini integration. Some providers support the rendered Chat UI; the others run in a terminal. See Providers and models for the current surface matrix and command names.
You may skip provider setup and add or enable providers later in Settings → Agents.
Complete first-run setup
Section titled “Complete first-run setup”The app asks three short questions:
- Choose a coding agent. Installed providers appear first. Select a default provider and model, reveal additional providers if needed, or skip this step.
- Choose a chat view. Pick Chat UI for rendered messages, markdown, and inline diffs, or Terminal for the provider’s native CLI interface.
- Choose a left sidebar. Pick Compact for feature-first navigation with Git details on hover, or Detailed for branch rows and status at a glance.
These choices are defaults, not permanent decisions. Change the agent surface in Settings → Agents and the sidebar style in Settings → Appearance.
Add a project
Section titled “Add a project”The welcome screen offers three entry points:
- Open project selects an existing repository or folder.
- Clone from URL clones a remote repository, then adds it.
- Quick start creates an Empty, Node, Python, or Rust project and initializes Git.
Adding the first project creates its workspace automatically. Continue with Your first workspace.
Updates
Section titled “Updates”The app checks for updates under Settings → General → Updates. Nightly is currently the only release track available, so releases can include newer behavior that changes quickly.