>_ Changelog

April 13, 2026

• Content font — JetBrains Mono now renders all reading surfaces (chat messages, spec editor, strategy doc, markdown, code, console, inputs); SF Pro stays on UI chrome (sidebar, buttons, canvas). Two-layer typography: content you read vs. controls you click. ~550 font calls migrated across 82 files
• Diff panel gutter fix — line numbers sit flush against the code again. The 50% empty column between gutter and content is gone; long lines scroll horizontally without pushing the gutter out of alignment
• Annotation popover grows with content — multi-line review comments no longer get clipped at four lines. Popover resizes to match the text as you type
• Session diffs survive relaunch — the Files panel now shows the correct change count after quitting and reopening Fermata. Previously sessions with active worktrees reported "0 changed" until the agent ran again
• Initiative name extraction works on the full spec — Mark Spec Ready now pulls the complete `# Heading` instead of whatever partial name was set mid-typing. No more initiatives called "A"
• SDD settings cleanup — removed the Approval Mode and duplicate Permission Profile controls from the SDD tab. Auto-approve silently skipped the review phase (dangerous); Permission Profile duplicated the Sessions tab. Both gone; defaults now land on the review-first, safe path
• Docs site — fermata.run/docs and docs.fermata.run now live with screenshots, videos, and a full getting-started walkthrough. Linked from header and footer

April 9, 2026

• Slash commands and skills in the prompt — type `/` in any prompt input (spawn, follow-up, or expanded modal) to see commands and skills from your project, user directory, and enabled plugins. Arrow-key navigation, frontmatter descriptions, and literal `/name args` dispatch straight to the CLI
• Plugin scoping — only plugins enabled for the current project (per installed_plugins.json) appear in the picker, so commands from other projects’ plugins don’t clutter your list
• Worktree-aware command discovery — picks up commands committed on the session branch in addition to your main repo’s uncommitted ones
• Homebrew installation — install Fermata with `brew tap kelios-io/fermata && brew install --cask fermata`. Auto-updates continue through Sparkle; `brew upgrade` is only needed for major version bumps
• Branch-switch diff refresh — when an agent runs `git checkout` or `git reset` inside its worktree, the Files panel, +/- counts, and canvas badge auto-refresh within a second via a filesystem watcher on `.git/HEAD`
• Clickable file tree rows — click anywhere on a folder row to expand, click a file row to open its inline diff. No more aiming at the tiny chevron
• Flattened folder chains — deep paths like `apps/macos/Fermata/Fermata/Features/AgentView` now render as a single breadcrumb row instead of 6 nested rows, matching GitHub and VSCode’s flatten-folders behavior
• Horizontal diff scroll — long lines scroll right while the line number gutter stays pinned on the left. Text selection preserved
• CLI Session ID in the inspector — visible, copyable, with a Copy Resume Command context menu that yields the full `claude --resume <id>` string. Paste straight into Terminal to continue in the CLI
• Tool rows show their target — every Read, Edit, Bash, Grep and friends row now shows what’s being touched (file path, command, pattern) with full value on hover. Copyable like any other text
• Selectable metadata — branch name, worktree path, tool arguments, and assistant message text can now be drag-selected or copied via right-click across the session detail, inspector, and approval card surfaces
• Vertical tool chips — chat tool groups now stack one tool per row so long bash commands and file paths get full width before truncation
• Tool targets survive app restart — persistence now round-trips structured tool input so the inspector activity list keeps its file paths and commands across relaunches
• Safer worktree cleanup — disabled the silent auto-cleanup that previously deleted branches on session completion. A footgun where any agent that committed its work and ended on a clean tree lost its branch without warning. All cleanup is now explicit via the per-session delete dialog
• Clear Done is non-destructive — the sidebar button now only removes sessions with no branch or worktree, and shows a confirmation dialog explaining what will and won’t be cleared. Sessions with branches stay put until you delete them individually
• Canvas node cards show full model names — Opus, Sonnet, and Haiku instead of ambiguous single letters. Fixes the case where capital O looked identical to zero at small sizes
• Compact inspector header — the session name no longer renders as a giant page title on the canvas right panel; it sits inline with the status pill
• Fixed auto-update for existing 0.2.0 users — the Sparkle appcast URL was missing from the Release build’s Info.plist, which broke "Check for Updates" in 0.2.0. If you’re on 0.2.0, download 0.3.0 manually from fermata.run (auto-update will work again starting with this release)

April 7, 2026

• macOS 15 Sequoia support — no longer requires macOS 26 Tahoe. macOS 26 is recommended for the full experience (Liquid Glass, minimap, animated zoom-to-fit). On macOS 15 the orchestrator runs in legacy canvas mode — drag, pan, zoom, selection, live edges all work
• Fixed crash on session start on macOS 15 in SubagentDurationLabel’s TimelineView
• Fixed crash on canvas mount on macOS 15 from SwiftFlow’s SwiftUI Canvas view
• Smart worktree management — cleanup confirmation for uncommitted changes, orphan detection on launch, merge-back with stash handling, branch preservation options
• Stop sessions from sidebar and inspector — hover to reveal stop button, no need to open Agent View
• Initiative prompt cards — orchestrator prompts collapsed into compact card with "View Full Prompt" detail window
• Chat pagination — sessions with hundreds of messages load smoothly with caching and stable scroll position
• Cancel PR creation — Cancel button and Escape shortcut to dismiss the PR sheet
• Auto-update via Sparkle — automatic update checks with Ed25519 signed releases
• Context window progress bar in session detail showing tokens used vs model limit (200K or 1M)
• Token counts replace dollar costs on session cards and detail panel
• Anonymous analytics (opt-out) via TelemetryDeck — no personal data collected
• Styled DMG installer with branded background
• Fixed "Open in Agent View" in initiative Tasks phase, auto-naming, gh CLI discovery, and diff panel performance

March 31, 2026

• Review phase: safe merge with stash handling, merge conflict detection
• Worktree cleanup on all completion paths — no more orphaned worktrees
• All review actions always visible: Mark as Done, Merge Back, Create PR
• PR creation moved to sheet — diff view always accessible during review
• Attachments fixed — images and screenshots now work via Read tool
• Attachment chips shown in chat for both initial prompt and follow-ups
• GitShell pipe deadlock fix — large diffs load instantly
• Chat panel: scroll-to-bottom on open, message truncation for long sessions
• Done view: View PR, Copy Branch buttons, phase navigation hint
• Complete view simplified: checkmark + Mark as Done
• gh CLI binary discovery for PR creation
• SDD default model correctly applied to new initiatives

March 30, 2026

• Plan detection uses word-boundary regex — "Give me a list of packages" no longer triggers plan review
• Initiative deletion fixed — persistence was creating duplicate folders on every save
• Settings: merged Pro Access and Developer Options into single tab, bigger hit areas
• Stop button now marks sessions as Done instead of Failed
• Project paths show ~/relative instead of full /Users/ path
• Spec editor: removed empty gap below text content

March 29, 2026

• Plan mode review — detect and display plan approval cards
• Feature flags and build tier system

March 24, 2026

• First notarized release — signed with Developer ID, hardened runtime
• Build script: archive, sign, notarize, DMG creation
• Strategy inline annotations — NSTextView-based markdown with text selection comments
• Error handling: CLI discovery banner, crash detection, rate limit UI
• Worktree management: orphan detection, cleanup, prune UI
• Cost tracking per session and aggregate in menu bar
• Session and settings persistence to disk
• Notification system: required input, session done, SDD phases
• Onboarding wizard, About panel, What's New screen
• AskUserQuestion card with batch rendering

March 18, 2026

• Initial build — Orchestrator canvas + Agent View
• SDD Mode — full 5-phase workflow: Spec, Strategy, Tasks, Agents, Review
• AI-powered task decomposition and strategy generation
• Agent teams with parallel subagent execution
• Git worktree isolation per session
• Tool approval flow (allow, deny, allow for session)
• Canvas node graph with SwiftFlow
• Embedded terminal (SwiftTerm)
• MarkdownUI chat rendering with code blocks
• Prompt composer with file attachments