Setup
[view as markdown]
Could not copy markdown source body. Please use "view as markdown".
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.
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 follows one of three theme preferences:
| Theme | Behavior |
|---|---|
| Light | Always use the light interface |
| Dark | Always use the dark interface |
| System | Follow your macOS appearance setting |
Switch themes from Settings.
Agent Integration
Section titled “Agent Integration”Claude Code agents work through the CLI. The desktop app detects local fp database changes from CLI writes, so changes made by fp commands in the terminal appear in the UI.