Mac App Overview
The fp Mac app is a native Electron desktop companion that provides a visual interface for issue tracking alongside the CLI. It’s designed for macOS with native vibrancy, a menu bar launcher, and keyboard-first navigation.
Features
Section titled “Features”- Tree view — Hierarchical issue visualization matching
fp tree - Agent tracking — Monitor Claude Code and Cursor agents in real time
- Command palette — ⌘K for quick actions (create, search, assign to agent)
- Menu bar launcher — Global hotkey access without switching windows
- Real-time updates — File system watching keeps the UI in sync with CLI changes
- Keyboard-first — Full navigation with j/k, arrow keys, and vim-style bindings
Architecture
Section titled “Architecture”The app runs three Electron processes:
| Process | Role |
|---|---|
| Main | Window management, IPC, fp-core integration, file watching |
| Preload | Secure context bridge exposing window.desktop API |
| Renderer | React UI with Zustand state management |
The main process delegates all issue operations to fp-core (the same library used by the CLI), so data is always consistent between the desktop app and terminal.
Tree View
Section titled “Tree View”The default view shows issues in a hierarchical tree, matching what you see with fp tree in the terminal:
- Status indicators (colored dots for todo/in-progress/done)
- Priority badges
- Expandable parent/child relationships
- Click to open detail panel
Detail Panel
Section titled “Detail Panel”Select any issue to see:
- Full title and description
- Status and priority
- Comments timeline
- Agent activity (if assigned to an agent)
- Diff preview for completed issues
Getting Started
Section titled “Getting Started”Download the Mac app from fp.dev/mac or check the setup guide.