Download the Mac appDownload
fp / changelog

> changelog

Release history and version notes for fp CLI and Desktop

Back to Home
v0.13.0 Desktop

Features

  • Add cascade delete for issues with sub-issues. Deleting a parent issue now deletes its entire subtree. The CLI requires --recursive (-r) to confirm, showing the affected subtree when omitted. The desktop app shows a confirmation dialog with the full descendant count. fp project gc --force now also cleans up stale dependency refs left behind by deleted issues.
  • Add inline description editing with Lexical rich text editor, floating toolbar, markdown mode toggle, and editor controls in collapsible section header.

Fixes

  • Fix extension properties briefly disappearing during optimistic updates.
  • Improve sync engine crash recovery to reduce cases where issue changes become silently stale. The app now detects and recovers from more failure scenarios, including workers that stall before their first sync and database changes that land during recovery pauses.
v0.12.1 Desktop

Fixes

  • Fix issue creation failing with "An object could not be cloned" when triggered from the sidebar button.
v0.12.0 Desktop

Features

  • Add author filter dropdown to the issue list. Appears when a project has multiple authors. Press a to open. Also adds --author flag to fp issue list.
  • Add right-click context menu to issue rows in the tree and flat list views with Copy Issue ID and Delete issue actions.
  • Add 'Create child issue' to right-click context menus and detail panel kebab menu.
  • Add dropdown combobox UI for editing extension properties in the detail panel. All registered properties show regardless of whether they have values. Multiselect uses search filter, checkmarks, and colored chips. Optimistic store updates with revert on failure. Global extensions shown per-project with toggle in settings.
  • Add extension seeder that auto-seeds default extensions into ~/.fiberplane/extensions/ for all users. Directory-based extensions with index.ts + package.json for version tracking. Seeder runs in ExtensionLive on every CLI command and once at desktop startup. Idempotent — never overwrites user modifications.
  • Redesign Create Issue modal with a cleaner, Linear-style UI. Wider modal (720px), borderless title and description inputs, auto-growing description area, compact metadata pill row, and parent issue picker styled as a proper dropdown pill.

Fixes

  • Fix issue detail panel flashing when adding a comment. Comments now merge into the existing cached data instead of wiping and refetching everything.
  • Add inline title editing with auto-growing textarea to the issue detail panel. Click the title to edit in place — long titles wrap instead of clipping. Enter or blur commits, Escape cancels.
  • **Breaking:** Rename ExtensionIssue.fields to ExtensionIssue.properties across the extension API. Extensions that read issue.fields, pass { fields: ... } to fp.issues.create()/update(), or inspect ctx.updates.fields in hooks must update to use properties instead. Fix extension property updates (e.g. labels) not reflecting immediately in the desktop app UI.
  • Preserve extension properties like labels in watcher- and sync-driven incremental issue patches so property edits no longer disappear from the open detail view until a reload.
v0.11.0 Desktop

Features

  • Add inline image preview thumbnails to the comment form before submit. Clicking the attach button now opens a native file picker, and paste/drop also work in sandboxed Electron. Constrain rendered attachment images to a reasonable max height.
v0.10.0 Desktop

Features

  • Add ability to delete issues from the desktop app.
v0.9.1 Desktop

Fixes

  • Fix keyboard shortcut tooltips showing wrong keybinding and misaligned text. Clear search bar when switching projects. Improve command bar result ranking and scroll behavior.
v0.9.0 Desktop

Features

  • Add tooltip system to the desktop app. Hovering any interactive element now shows a styled tooltip with an optional keyboard shortcut badge. Tooltips appear instantly with no native browser delay. Shortcut badges distinguish between chords (keys held together, shown as adjacent badges) and sequences (press one then the other, shown with a "then" separator). The keyboard shortcuts modal (?) has been updated to match this display convention and no longer lists shortcuts that were not functional. Typing "project" or "switch" in the command bar (⌘K) now surfaces the Switch Project items.
  • Custom issue properties system for extensions. Extensions register typed properties via registerProperty(key, options) with select, multiselect, and text display types. Values are stored as peers of built-in attrs in the Y.Doc attrs map — no schema version bump, no migration, full CRDT merge safety. The desktop renderer shows extension properties in a unified Properties section with colored chips, dots, icons, and inline editing.

Fixes

  • Fix misaligned avatars in the issue list caused by variable-width date text. The date column now has a fixed width so avatars stay vertically aligned.
  • Remove extension feature-flag gating so extensions are enabled by default in CLI and desktop, and simplify desktop e2e setup accordingly.
  • Show author avatars on comments instead of generic user icon, and add a subtle drop shadow to the comment input box. Comment avatars always render (initials fallback) even when unauthenticated to prevent layout misalignment.
  • Remove the last extensions feature-flag surfaces now that extensions are enabled by default, and fix the desktop settings updater flow so successful downloads no longer surface a false "Failed to download update" error.
  • Fix desktop updater settings state handling so download failures are propagated through IPC and the settings UI can reliably reflect the correct download result.
  • Fix status dropdown getting clipped in the Create Issue modal.
  • Reduce the invite teammate email input focus ring from 2px to 1px, consistent with other input fields in settings.
  • Reduce default sidebar width by ~35% for a more compact layout
  • Increase vertical spacing between settings sidebar navigation items for better visual breathing room.
  • Fix false positive "CLI Not in PATH" warning when fp is configured in .zshrc.
  • Faster loading of issue details.
  • Fix stale issue detail persisting in the detail panel after switching projects. The selected issue and cached details are now cleared when the issue set is replaced. The "Select an issue" placeholder is now vertically centered in the detail pane.
v0.8.0 Desktop

Features

  • Show GitHub avatars for all workspace members on issues, not just the current user. Adds a workspace members API endpoint, a member directory lookup in the desktop app, and updates the AuthorAvatar component to resolve teammate avatars by email or GitHub username.
v0.7.0 Desktop

Features

  • Add application log viewer window and extension live reload. Application log viewer: a dedicated window showing live and historical desktop logs with scope/level filtering, text search, expandable rows with copy-to-clipboard, resizable columns, and virtualized rendering. Accessible via command bar ("Show application logs") or Settings > General > Diagnostics. Extension live reload: watches extension directories for file changes and performs drain-before-restart process reload with debouncing. Also removes node: imports from fp-core (extension-secrets, extension-loader, database service) to keep it runtime-agnostic, and adds an ast-grep rule enforcing this.
  • Overhaul realtime updating logic for issue data.
  • Add Cmd+F find-in-page search scoped to the detail pane. Press Cmd+F to open a find bar, Cmd+G / Cmd+Shift+G (or Enter / Shift+Enter) to navigate matches, and Escape to close.

Fixes

  • Add collapsible nav sidebar for project and pinned issue navigation. Toggle with Cmd+[ or the toolbar button; drag the right edge to resize up to 40% of window width. Migrate NavBar to shadcn Sidebar sub-components for item-level keyboard highlight. Cmd+] toggles the detail panel. Detail panel content is frozen during divider drag to prevent layout reflow.
  • Add theme-aware scrollbars that adapt to light and dark mode.
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
2026-02-16

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.4.0 Desktop
2026-02-06

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.19.0 CLI

Features

  • Add cascade delete for issues with sub-issues. Deleting a parent issue now deletes its entire subtree. The CLI requires --recursive (-r) to confirm, showing the affected subtree when omitted. The desktop app shows a confirmation dialog with the full descendant count. fp project gc --force now also cleans up stale dependency refs left behind by deleted issues.

Fixes

  • Add --format json flag to fp comment list for machine-readable output.
  • Fix fp sync issue update sending a spurious status: false when --status is not provided, which caused a 422 validation error from the server.
  • Add --format json flag to fp issue get for machine-readable output including custom properties.
v0.18.1 CLI

Fixes

  • Polish the fp init experience: nicer step dividers, arrow-key agent picker, and less noisy setup prompts.
  • Add fp project update --prefix <value> to update the local project prefix in .fp/config.toml.
v0.18.0 CLI

Features

  • Add author filter dropdown to the issue list. Appears when a project has multiple authors. Press a to open. Also adds --author flag to fp issue list.
  • Add --property key=value repeatable flag to fp issue create and fp issue update for setting extension-registered custom properties. Multiselect properties accept comma-separated values. fp issue show now displays extension properties in a "Fields:" section. Fix hook payloads to always include extension fields so extensions can react to property values on create, update, and status change events.
  • Add extension seeder that auto-seeds default extensions into ~/.fiberplane/extensions/ for all users. Directory-based extensions with index.ts + package.json for version tracking. Seeder runs in ExtensionLive on every CLI command and once at desktop startup. Idempotent — never overwrites user modifications.

Fixes

  • **Breaking:** Rename ExtensionIssue.fields to ExtensionIssue.properties across the extension API. Extensions that read issue.fields, pass { fields: ... } to fp.issues.create()/update(), or inspect ctx.updates.fields in hooks must update to use properties instead. Fix extension property updates (e.g. labels) not reflecting immediately in the desktop app UI.
  • fp context --include-children now shows the full descendant tree recursively, not just direct children. Nested sub-issues appear with indentation to reflect their depth.
v0.17.1 CLI

Fixes

  • Improve fp context -c output: child issues now render as full markdown sections separated by dividers instead of blockquotes.
v0.17.0 CLI

Features

  • Improve fp context --include-children output with proper markdown formatting for better readability. Add -c shortcut alias for --include-children.

Fixes

  • Add fp extension docs command to print the extensions authoring guide. Update FP_CLAUDE.md to mention the extension system.
  • Add optional remote project linking prompt during fp init when experimental_sync is enabled.
v0.16.2 CLI

Fixes

  • Remove extension feature-flag gating so extensions are enabled by default in CLI and desktop, and simplify desktop e2e setup accordingly.
  • Remove the last extensions feature-flag surfaces now that extensions are enabled by default, and fix the desktop settings updater flow so successful downloads no longer surface a false "Failed to download update" error.
  • Fix .fp resolution in git worktrees and jj workspaces when extension files are checked in but .fp/config.toml is untracked. The CLI now resolves the shared main checkout project instead of registering a new standalone project from a partial .fp/ directory.
v0.16.0 CLI

Features

  • Refactor fp setup claude to install and manage Claude integration assets directly in the project instead of relying on marketplace/plugin installation. ### Highlights
    • Bundle Claude integration assets in the CLI repo (apps/fp/src/integrations/claude):
    • fp-plan, fp-implement, and fp-review skills
    • PostToolUse hook templates
    • bundle manifest metadata
    • Embed bundled Claude assets into the compiled fp binary so fp setup claude works in shipped binaries (not just source/dev runs).
    • Add a versioned state file at .fp/integrations.json to track what fp manages (resource hashes, migration info, and reconciliation state).
    • Merge fp-managed PostToolUse hook into .claude/settings.local.json non-destructively.
    • Keep Claude instructions at project root (FP_CLAUDE.md) and ensure CLAUDE.md references @FP_CLAUDE.md (including migration from legacy @.fp/FP_CLAUDE.md).
    • Add legacy marketplace detection/migration warnings for dual-install states.
    • Expand setup tests to cover bootstrap, idempotency, drift/repair, migration scenarios, and corrupt sidecar/settings recovery.
    • Update documentation for the new project-managed setup flow and future integration adapter model.
  • Harden performance of database reads for issue data and add support for a metadata index. Add fp project db reindex and fp project db compact commands for database maintenance.
  • Add --sort flag to fp issue list and --limit flag to fp tree. fp issue list now defaults to showing in-progress and high-priority issues first. Use --sort <key> to sort by status, priority, updatedAt, createdAt, or title. fp tree --limit <n> caps the number of nodes shown and appends a dim … (N more) line when truncated.
  • Track the author who created each issue. The author is automatically set when creating issues and displayed in issue metadata.

Fixes

  • Add application log viewer window and extension live reload. Application log viewer: a dedicated window showing live and historical desktop logs with scope/level filtering, text search, expandable rows with copy-to-clipboard, resizable columns, and virtualized rendering. Accessible via command bar ("Show application logs") or Settings > General > Diagnostics. Extension live reload: watches extension directories for file changes and performs drain-before-restart process reload with debouncing. Also removes node: imports from fp-core (extension-secrets, extension-loader, database service) to keep it runtime-agnostic, and adds an ast-grep rule enforcing this.
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
2026-02-16

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.13.2 CLI
2026-02-06

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
2026-02-05

Features

  • Add feedback form in the Desktop app.

Fixes

  • Updated colors.
v0.2.0 Desktop
2026-02-05

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
2026-02-05

Fixes

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

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
2026-01-19

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
2026-01-13

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
2026-01-05

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
2025-12-20

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
2025-12-19

Fixes

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

Fixes

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

Features

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

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
2025-12-15

Fixes

  • Make fp setup claude idempotent.
v0.5.0 CLI
2025-12-13

Features

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

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
2025-12-08

Features

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

Features

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

Fixes

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

Fixes

  • Internal refactoring.
  • Improve error reporting.
v0.1.2 CLI
2025-12-03

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
2025-12-02

Fixes

  • Internal refactoring. Move agent identity to global config.
v0.1.0 CLI
2025-12-02

Features

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