fp for Mac
Keyboard shortcuts & reference
Everything you need to know about navigating fp for Mac. For an overview and download, see the main page.
Requires macOS with Apple Silicon (M1/M2/M3/M4).
The Launcher
The launcher is a spotlight-like command palette that appears when you press the global hotkey. It's the fastest way to access your issues.
⌘⇧I Summons the launcher from any app
Type to search Filter issues instantly as you type
j / k Navigate up and down (vim-style)
Enter Open the selected issue
⌘N Create a new issue
Esc Close the launcher
The launcher auto-hides when you click outside, just like Spotlight.
Main Window
Press ⌘K and select "Open App" to access the full main window with tree view, filters, and a detail panel.
Views
Tree View See issues in a parent-child hierarchy. Great for epics and subtasks.
Flat View A linear list of all issues. Useful for sorting by status or priority.
Layout
⌘B Toggle the sidebar
⌘⇧⏎ Maximize the detail panel
Drag edges Resize the sidebar and detail panel
Keyboard Shortcuts
Navigation
j Next issue
k Previous issue
Space Scroll down
⇧Space Scroll up
/ Focus search
Esc Go back
Actions
⌘D Toggle done
⌘⏎ Cycle status
⌘P Pin issue
⌘. Copy ID
Windows
⌘⇧I Toggle launcher
⌘K Command bar
⌘N New issue
⌘B Toggle sidebar
⌘, Settings
? All shortcuts
Search Syntax
Beyond free-text search, use filters to narrow down issues:
status:todo Show only todo items status:in-progress Show work in progress status:done Show completed items parent:FP-xkcd Filter by parent issue has:children Show only issues with subtasks Combine filters with text: status:todo auth finds todo issues containing "auth".
Settings
Open settings with ⌘, to customize your experience:
Global Hotkey Change the launcher shortcut from the default ⌘⇧I
Theme Choose Light, Dark, or follow System preference
Launch at Login Start fp automatically when you log in
Update Channel Choose Stable, Latest (pre-release), or Preview builds
Tips
- Switch projects fast: Use the project picker in the launcher footer or command bar.
- Pin important issues: Press ⌘P to keep issues at the top of lists.
- Keyboard-first: You can do almost everything without touching the mouse.
- Real-time sync: Changes sync automatically between the launcher and main window.
- Quick copy: Press ⌘. to copy an issue ID for pasting in commits or chat.