Download the Mac appDownload
fp / changelog

> changelog

Release history and version notes for fp CLI and Desktop

v0.6.0 Desktop

Features

  • Add CLI status indicator to the footer toolbar and a new CLI settings section. The desktop app now detects whether the fp CLI is installed and up to date, showing a Terminal icon in the footer (green when ok, yellow when outdated, red when missing). Clicking opens a new CLI settings page with version details, install/update commands, and a copy-to-clipboard button.
  • Add extensions system for custom automation hooks (behind feature flag).
  • - **Zoom into subtree** - press z to scope the issue list to any issue's subtree; ⌘↑ goes to parent; Escape exits zoom; a filter chip shows the active scope
    • **Search improvements** - matching text highlighted in results; clear button replaces / hint when text is present; Escape clears search immediately
    • **Status count bar** - footer shows per-status issue counts; clicking a status toggles it out of view (exclude filter); status filter dropdown and footer toggles are now independent
    • **Keyboard help modal** - arrow keys scroll immediately on open; focus returns correctly to the active pane on close; adds missing shortcuts (⌘N create, ⌘D set done); rebalances groups into Navigate / Filter & Sort / Actions / Window
    • **Filter chips** - pill shape, muted background, semantic colors
  • Raise pin limit from 3 to 10. Show a toast warning when the limit is reached. Replace inline copy-to-clipboard feedback with a toast notification.

Fixes

  • Improve accessibility via keyboard navigation
  • Fix Launcher search input not regaining focus after closing issue creation modal or keyboard help overlay.
  • Replace inline copy feedback with a Sonner toast notification when copying issue IDs. Toast appears above the footer with a 1.5s auto-dismiss.
v0.5.0 Desktop

Features

  • Add Story Canvas UI with review integration. Story view renders markdown narratives interleaved with diff, file, and chat blocks. Review app supports toggling between diff view and story view. Desktop settings gains an experimental_story feature flag.

Fixes

  • Add support for experimental remote sync feature inside a new settings pane.
  • Add welcome screen with onboarding cards showcasing the Plan, Implement, and Review workflow.
  • Add workspace selection to project link and create flows.
v0.15.0 CLI

Features

  • Add extensions system for custom automation hooks (behind feature flag).
  • Add session-issue linking via Claude Code hooks. When you run fp commands in Claude Code, sessions are automatically linked to issues you interact with. Add fp issue sessions <id> command to list all sessions that have touched an issue.

Fixes

  • Fix "Migrating to new ID format..." printing on every command when issues were already migrated but activity log still had deprecated events.
  • Add optimizations for experimental sync engine.
v0.14.0 CLI

Features

  • Add fp story commands for creating and managing code review narratives. Use fp review --with-story to view stories in the desktop app. Remove browser-based review flow — fp review now opens exclusively in the desktop app.
  • fp setup claude now grants Claude Code access to read and edit ~/.fiberplane/ files. This allows Claude to work properly in sandboxed environments where it needs permission to access Fiberplane configuration.

Fixes

  • Make fp issue list output responsive to terminal width. The title column now scales from 20 to 80 characters based on available terminal space, with sensible defaults when width is unavailable.
  • Add --workspace flag to project clone for filtering projects by workspace. Fix flat project list in interactive clone mode.
v0.4.0 Desktop

Features

  • Redesign main window UI: simplified top bar, new issue list controls, updated detail view with collapsible sections. Tree items reordered to show status, ID, title, priority, and date. Comments now render markdown. Smoother animations when opening/closing detail view. App opens main window on launch and dock icon stays visible. Updated status icons, command bar styling, and color tokens.
  • Redesign dropdown components with shared DropdownButton trigger, searchable multi-select filters, and consistent menu item styling across status, priority, and filter pickers.

Fixes

  • Fix keyboard shortcuts (Cmd+Enter, Cmd+D, Cmd+P, Cmd+Shift+Enter) triggering while typing in input fields.
  • Fix desktop app defaulting to "FP" prefix for all projects. Now loads and displays the project's configured prefix from .fp/config.toml. Show orphaned projects (deleted repos) with visual distinction - warning icon, "Not found" badge, and prevent selection. Add recovery flow for projects with missing config files.
  • Fix review comment submission when issue opened with short ID prefix
  • Consolidate icon button sizes to a single 28px round variant.
v0.13.2 CLI

Fixes

  • Fix review comment submission when issue opened with short ID prefix
  • Prevent duplicate project registry entries when running fp commands in git worktrees. Detect existing projects in the main checkout and guide users accordingly. Add garbage collection for duplicate registry entries via fp project gc.
v0.3.0 Desktop

Features

  • Add feedback form in the Desktop app.

Fixes

  • Updated colors.
v0.2.0 Desktop

Features

  • Redesign launcher UI with polished animations, improved keyboard navigation, and multi-monitor support. Rename app to "fp" with new blue icons. Add Geist font, new FpMenu component, and various performance and UX improvements.
  • Add toast notifications when updates are available and fix auto-updater configuration.

Fixes

  • Internal refactoring.
  • Rename app from "Fiberplane" to "fp" in UI text, tooltips, and menu labels.
v0.13.1 CLI

Fixes

  • Fix fp issue assign crashing when using multiple --rev flags.
  • Some bug tweaks and improvements.
v0.13.0 CLI

Features

  • Simplify issue IDs to use shorter, easier-to-type prefixes. Existing projects are automatically migrated on first run.

Fixes

  • Improve privacy in error reports by masking home directory paths.
  • Add edit alias for fp issue update command.
v0.12.0 CLI

Features

  • Add interactive issue selector when typing ambiguous ID prefixes.
  • Show project-specific prefix in help examples instead of default FP-.
  • Hide experimental fp auth command from help by default.
  • Prompt to set up Claude Code plugin after running fp init.
  • Improve fp init with styled output, smart prefix suggestions, and repository warnings.

Fixes

  • Store Claude instructions in .fp/FP_CLAUDE.md for easier updates.
  • Improve fp update output styling.
v0.11.0 CLI

Features

  • Automatically strip colors when output is piped. Supports NO_COLOR and FORCE_COLOR environment variables.
  • Replace sequential issue IDs with hash-based IDs. Type short prefixes like abc to match issues, with case-insensitive matching.
  • Add --format json flag to fp issue list for machine-readable output.
  • Improve support for git worktrees and jj workspaces.

Fixes

  • Add create alias for fp comment add command.
  • Internal refactoring.
  • Fix fp issue list not reading the project prefix from the correct config file.
  • Fix duplicate storage directories when running fp init in git clones or worktrees.
  • Improve error reporting.
  • Add fp issue assign to Claude Code instructions.
  • Improve Linux binary compatibility with musl-based systems (Alpine).
  • Remove automatic commit tracking on status changes. Use fp issue assign for explicit tracking.
  • Remove fp web command.
  • Fix fp review port fallback when default port is unavailable.
  • Improve fp review validation and copy button feedback.
  • Fix revisions display to show all assigned commits.
v0.9.0 CLI

Features

  • Add fp dispatch command to start Claude Code on an issue.
  • Add fp sync command for syncing issues with the Fiberplane Console.
  • Add working copy review mode. Run fp review without an issue ID to review uncommitted changes.

Fixes

  • Remove git trailer functionality to avoid merge conflicts.
v0.8.0 CLI

Features

  • Add priority field to issues (low, medium, high, critical) with color-coded display.

Fixes

  • Fix issue ID normalization to use project prefix instead of default FP-.
v0.7.2 CLI

Fixes

  • Add automatic port discovery to fp review command. Fix issue assignment command hanging.
v0.7.1 CLI

Fixes

  • Fix fp issue diff for legacy issues with lowercase ref tags and single-revision cases
v0.7.0 CLI

Features

  • Add fp review command to open a web-based diff viewer for reviewing issue changes and adding comments.
v0.6.0 CLI

Features

  • Accept flexible issue ID formats (FP-18, fp-18, 18, fp18).

Fixes

  • Add --body alias for --description in issue commands.
  • Show restart reminder after fp update.
v0.5.1 CLI

Fixes

  • Make fp setup claude idempotent.
v0.5.0 CLI

Features

  • Add fp setup claude command to install the Claude Code plugin and configure AI agent instructions.
v0.4.0 CLI

Features

  • Simplify status model to three states: todo, in-progress, and done.
  • Add git and jj (Jujutsu) support for tracking issue changes. Use fp issue diff and fp issue files to see changes.
v0.3.0 CLI

Features

  • Add commands to view issue changes: fp issue diff shows a unified diff, fp issue files lists changed files.
v0.2.0 CLI

Features

  • Add fp project command to manage registered projects. Projects are now discoverable from any subdirectory.
v0.1.4 CLI

Fixes

  • Accept kebab-case status values. Add fp comment shorthand.
v0.1.3 CLI

Fixes

  • Internal refactoring.
  • Improve error reporting.
v0.1.2 CLI

Fixes

  • Fix an issue where invalid status values would show obscure error messages. Status will now be unambiguous about the values it can take.
v0.1.1 CLI

Fixes

  • Internal refactoring. Move agent identity to global config.
v0.1.0 CLI

Features

  • Initial release of the fp CLI for local-first issue tracking.