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

- **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

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.

## Views

### 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

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

Download the Mac app from [fp.dev/mac](/mac) or check the [setup guide](/docs/mac/setup).