## Requirements

- **macOS** (Apple Silicon or Intel)
- **fp CLI** installed and initialized in at least one project

## Download

Download the latest version from [fp.dev/mac](/mac).

## First Launch

1. Open the app — it appears in both the Dock and the menu bar
2. The app automatically detects fp projects in your home directory
3. Select a project to view its issues

## Menu Bar Launcher

The menu bar icon provides quick access:

- Click the menu bar icon (or use the global hotkey) to open the launcher
- Type to search issues
- Press Enter to open an issue in the main window

## Global Hotkey

Configure a global hotkey in Settings to instantly access fp from anywhere on your desktop.

## Themes

The Mac app ships with multiple themes:

| Theme | Style |
|-------|-------|
| **Default Dark** | Cool-neutral dark surfaces |
| **Default Light** | Clean white with green-gray accents |
| **Midnight Blue** | Blue-tinted dark surfaces |
| **Sand** | Warm neutral light theme |

Switch themes from Settings or the command palette (⌘K → "theme").

## Agent Integration

### Cursor Agent Tracking

The desktop app can monitor Cursor agents working on issues:

1. Assign an issue to a Cursor agent (⌘K → "Assign to Cursor")
2. The agent status badge appears on the issue row
3. Open the agent panel to see conversation and progress
4. Auto-transition to done when the agent completes (configurable)

### Claude Code

Claude Code agents work through the CLI. The desktop app stays in sync via file system watching — any changes made by `fp` commands in the terminal appear instantly in the UI.