Setup
Requirements
Section titled “Requirements”- macOS (Apple Silicon or Intel)
- fp CLI installed and initialized in at least one project
Download
Section titled “Download”Download the latest version from fp.dev/mac.
First Launch
Section titled “First Launch”- Open the app — it appears in both the Dock and the menu bar
- The app automatically detects fp projects in your home directory
- Select a project to view its issues
Menu Bar Launcher
Section titled “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
Section titled “Global Hotkey”Configure a global hotkey in Settings to instantly access fp from anywhere on your desktop.
Themes
Section titled “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
Section titled “Agent Integration”Cursor Agent Tracking
Section titled “Cursor Agent Tracking”The desktop app can monitor Cursor agents working on issues:
- Assign an issue to a Cursor agent (⌘K → “Assign to Cursor”)
- The agent status badge appears on the issue row
- Open the agent panel to see conversation and progress
- Auto-transition to done when the agent completes (configurable)
Claude Code
Section titled “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.