Changelog

New updates and improvements to Admiral.

v2.0.0

Requires macOS 15.0

  • • Workspaces: a new layer between Project and Chat. Each workspace owns its branch (and optional worktree), active chat, inspector tab, terminal pane, and PR metadata, so multiple parallel tasks no longer collide on a single branch
  • • Persistent Tab Bar: native AppKit workspace tab bar in the content area with per-tab agent icon, hover ellipsis menu, close button, and inline "New Chat", always visible regardless of how many tabs are open
  • • Workspace Rename: rename any workspace from its tab or sidebar row
  • • Archived Workspaces: archive workspaces from the sidebar; restore or permanently delete them from a new Preferences pane
  • • Worktree Picker: create a worktree-backed workspace from an existing branch or a remote ref (with automatic tracking-branch creation), based off any branch you choose instead of always HEAD
  • • Workspace Name in Chat Header: the chat header now shows the active workspace and agent
  • • Multi-Profile Support: sign into multiple Claude Code accounts and switch between them. Each profile has its own CLAUDE_CONFIG_DIR, so credentials, sessions, and projects stay separate
  • • Profile Pager: profile dots in the sidebar footer let you flip between profiles; drag to reorder, right-click to rename, set default, or delete
  • • Profile Customization: pick a color and icon for each profile, applied to the profile dot, workspace icons, and port/terminal/issue badges
  • • Per-Profile Auth Status: Admiral continuously probes claude auth status per profile, surfacing login state and account email in the profile header and Preferences
  • • Profile-Aware Login: the login PTY sheet writes credentials into the active profile’s config dir instead of polluting ~/.claude
  • • Drag Projects Between Profiles: drop a project onto a profile dot to move it (with its chats) to that account
  • • Profiles Preferences Pane: full CRUD for profiles in Settings, with a per-profile login button and live account state
  • • Codex Agent: Admiral now runs the Codex CLI alongside Claude through a unified AgentAdapter protocol. Pick the agent per chat and the right CLI launches with the right config dir
  • • Per-Tab Model Selection: each chat tab remembers its model (Claude or Codex) and shows the agent icon directly on the tab
  • • Opus 4.8: refreshed the Claude model lineup with Opus 4.8 as the new default
  • • Per-Profile Codex Home: Codex login state and credentials are tracked per profile, mirroring the Claude setup
  • • Codex Login Validation: signing into Codex in onboarding validates credentials before completing the step
  • • Automation Flows: define multi-step agent flows with a Coordinator chat that spawns Implementer and Reviewer subagents, configurable per-project or globally
  • • Agent Definitions: reusable subagent definitions (system prompt, model, allowed tools), managed from the new Agents sidebar tool
  • • Quality Gates: scripted shell checks that run between flow phases. Failed gates feed a formatted message back into the Coordinator chat to drive the next iteration
  • • Run from the Inspector: kick off an automation run from an issue’s inspector; a status banner shows the active phase, iteration count, and gate results
  • • Default Flows Seeded: first launch seeds a starter Implementer + Reviewer flow you can edit or duplicate
  • • Run Recovery: in-flight runs are bootstrapped on app relaunch so a restart doesn’t lose progress
  • • Flows Sidebar Tool: full CRUD for flows in a new sidebar tool, alongside Agents
  • • Pull Request Creation: new PR bar in the Changes tab with Create PR and Create Draft PR buttons. Push, create, and link PRs directly from the inspector
  • • AI-Powered PR Descriptions: Auto-fill generates a detailed PR title and markdown description (Summary, Changes, Test Plan) using the active agent, with a live markdown editor for the description field
  • • GitHub REST API: PR creation now uses the GitHub REST API with system git credentials (git credential fill/approve/reject), no gh CLI required, works out of the box
  • • Source Control Preferences: new Source Control tab in Settings with Enable Source Control toggle, GitHub account management with live token validation, Git author/email and global gitignore, and auto-refresh / auto-fetch / prefer-rebase options
  • • Git Operations Menu: ellipsis menu in the Changes tab toolbar for Merge Branch, Rebase Branch, Stash Changes, and Push Changes
  • • Linked PR Auto-Refresh: linked PR status refreshes automatically; Copy-link button added next to the PR URL
  • • PR Metadata Cache: PR URL, title, status, and draft state are cached on the workspace, so the inspector stays populated when offline or switching workspaces
  • • Workspace PR State: PR sheet fields clear on cancel and on workspace switch, preventing stale data from carrying over
  • • Cancellable Commit Titles: AI commit-title generation can now be cancelled mid-stream
  • • Issue Tracking: create issues with title, description, type, priority, due date, project-scoped labels, and milestones; organize on a kanban board with Backlog, Planned, In Progress, and Done columns
  • • Checklist Items: add checklist items to any issue and edit them inline with keyboard navigation; they’re included in @task context
  • • Issue ↔ Workspace Linking: link an issue to a workspace to get Issue Detail and Plan tabs in the inspector with bidirectional status sync
  • • @task Inline Mentions: type @task in chat to inject the linked issue’s full context (title, type, priority, status, labels, milestone, due date, description, plan, checklist), highlighted in indigo as you type and shown as a chip in the sent bubble; a system warning appears if the workspace isn’t linked
  • • New Issue ⌘I: keyboard shortcut opens a floating issue-creation window from anywhere in the app
  • • Responsive Kanban: the board reflows for narrow widths; cards show a project badge in multi-project views
  • • Priority Cellular Bars: each card visualizes priority with a four-segment cellular bar
  • • Finder-Style Search: collapsible search field in the Planner toolbar
  • • Hover Status Toggle: hover an issue card to cycle its status without opening it
  • • Skill Version Row Menu: version rows in the inspector now have a hover ellipsis menu for Preview, Restore, Edit Label, and Delete
  • • Skill Version Preview Window: redesigned with a two-pane split layout matching the main Admiral window, with a material sidebar file list, headerView toolbars, edge-to-edge content, and read-only live markdown rendering for .md files
  • • Swipe to Reveal Timestamps: drag the message list left, iMessage-style, to peek at per-message timestamps
  • • Code Block Syntax Highlighting: code blocks now render in dedicated card views with syntax highlighting, copy buttons, and consistent sizing while streaming
  • • Resizable Table Columns: drag column dividers in markdown tables to resize
  • • Collapsed Tool Groups: consecutive tool calls collapse into a single "X tools called" row with tool icons; expand to see each tool and its diff preview
  • • Inline Chat Creation: add a new chat directly from the workspace tab bar
  • • Chat Hover States: tool messages and subagent cards now show subtle hover backgrounds
  • • Chat Input Polish: undo support, smart-quote/dash substitution disabled, and tab-key navigation in the in-app text editor
  • • Reliable Scroll Behavior: the latest message and incoming permission cards stay pinned above the input bar, including when the input grows or a permission request arrives mid-stream
  • • In-App File Editor: open files into a native editor overlay with line numbers and a scrollable minimap
  • • File Conflict Resolution: dragging or dropping files into a folder that already contains a same-named entry prompts to skip, replace, or keep both
  • • Show Hidden Files: new preference toggles visibility of dotfiles in the navigator; .git and .DS_Store are filtered consistently across git status
  • • Issue Detail Tab: when a workspace is linked to an issue, the inspector adds Issue Detail and Plan tabs with full editing
  • • Inspector Swipe Navigation: swipe horizontally between inspector tabs
  • • Persistent Tab Selection: the inspector remembers which tab you had selected per workspace
  • • Inspector Simplified: removed the standalone Plan tab; plan approval still works via the existing sheet/window
  • • Settings Sidebar Layout: Settings now uses a sidebar-based split view with edge-to-edge content and a collapsible detail inspector, replacing the toolbar tab strip
  • • Project Settings Sheet: per-project settings accessible from the sidebar context menu, ellipsis menu, and project overview toolbar; configure the project folder path, default branch for new workspaces, and remote origin URL
  • • Project Icon & Color: pick an SF Symbol and accent color per project, applied across the sidebar and workspace icons
  • • Archived Chats Auto-Cleanup: configurable retention with a clean AppKit picker; archived chats older than the chosen interval are pruned automatically
  • • Action Buttons Redesign: action settings now use a grouped card list with hover ellipsis menus (Edit, Duplicate, Delete), drag-and-drop reordering with spring animations, edit mode via a secondary sheet, and multiline script input for multi-command workflows
  • • Native CLI Installer: dependency check installs Claude Code via the official native installer, with no more EACCES failures and no Node.js required
  • • NVM Detection: onboarding detects and handles existing nvm installs gracefully
  • • PTY-Backed Login Sheet: the Claude and Codex login flows now run inside a PTY sheet inside Admiral instead of bouncing to Terminal
  • • Continue Button Polish: the "Get Started" button matches the capsule styling of dependency-check screens and anchors to the bottom on all screens
  • • Onboarding Dark Mode Fixes: all onboarding screens now correctly switch backgrounds between light and dark mode
  • • New App Icon: Admiral has a fresh new app icon reflecting the updated brand identity
  • • Liquid Glass on macOS 26+: chat surfaces adopt the new Liquid Glass material on supported systems
  • • Squircle Workspace Icons: workspace icons now use a squircle clip with project-color tinting
  • • Refreshed Control System: comprehensive migration to a unified ForgeButton / ForgePicker / ForgeDatePicker set with consistent corner radius, hover, and disabled-state treatments across the app
  • • New Tool Icons: Agents (sparkles) and Flows (bonjour) sidebar tools have dedicated icons; Pulse and Planner gain refreshed assets
  • • Permissions as a Panel: permission questions now open as a floating panel window instead of a modal sheet, so they don’t block the main window. The question sheet’s material background now sits inside the sheet for a cleaner edge
  • • Streaming Performance: optimized chat rendering during agent responses, including selective row reloads, batched SwiftData saves (30×/sec → 2×/sec), incremental content-height tracking, markdown renderer LRU caching, Highlightr instance caching, cheap height estimates while streaming, and exact sizing for tables and code blocks
  • • Project Overview Speed: hygiene panels load off the main actor with a TTL cache, npm-outdated and disk-usage queries are deferred to taps, and the overview uses LazyVStack so projects with many workspaces scroll smoothly
  • • Git Status Throughput: batched git status calls, coalesced refresh races, rename parsing fixes, and filtering of already-staged files during commit
  • • Pulse Activity Backfill: new ChatActivityDay denormalization table caches per-day activity so the Pulse tool doesn’t scan every chat on every open; backfill is deferred so it doesn’t block launch
  • • Lazy Terminal Sessions: workspaces no longer eagerly spawn terminals; they’re created when the terminal panel is first shown, and the last session can be closed
  • • Terminal Padding: the terminal pane now has padding around the terminal view with a background color that blends with the terminal theme in both light and dark mode
  • • Major Internal Refactor: fixed memory leaks in view controllers, added thread-safe session management, moved blocking git credential checks off the main thread, hardened the Claude process bridge against buffer overflows and race conditions, added SwiftData save error logging, decomposed the 1,400-line ChatSession into focused modules, and split the 2,200-line Preferences window into per-tab files
Download v2.0.0

v1.0.11

Requires macOS 15.0

  • • Skills Versioning: every save to a skill now creates a version snapshot stored in SwiftData with full version history, one-click restore, and labels for important milestones
  • • Directory-Level Versioning: skills backed by a directory snapshot all pages together as a single version, so restoring rolls back the entire skill atomically
  • • History Tab in Inspector: new clock icon tab in the inspector panel shows version history when a skill is selected with version number, timestamp, optional label, and a Restore button
  • • Versioned Schema Migration: introduced SwiftData VersionedSchema (V1) and SchemaMigrationPlan to safely add the SkillVersion model without data loss
  • • Skill Toolbar Reorder: toolbar buttons are now ordered left-to-right as Save, Undo, divider, Add Page, Open in Finder, and context menu for a more logical workflow
  • • Text Save Button: the skill toolbar save button now displays "Save" as text with flexible width instead of an icon, improving clarity
  • • Focus Chat Input (Cmd+L): new keyboard shortcut to instantly focus the chat input box from anywhere in the app
  • • Toggle Dictation (Cmd+J): new keyboard shortcut to start or stop voice dictation in the chat input, accessible from any panel
  • • Stop Agent (Cmd+.): new keyboard shortcut to interrupt the running agent with graceful interrupt on first press and force-stop on second press
  • • Sidebar Footer: new footer bar at the bottom of the sidebar with quick-access Settings button and a Help menu mirroring the menu bar
Download v1.0.11

v1.0.10

Requires macOS 15.0

  • • Session Import Browser: new standalone window for browsing and importing existing Claude Code sessions from disk, with search, date and model filters, date-grouped sections, multi-select with checkmarks, and deduplication of already-imported sessions
  • • Session Preview: preview a session's full message history in a read-only window before importing; click the eye icon on any row to open it
  • • Batch Import: select multiple sessions and import them all at once with progress feedback
  • • Customizable Keyboard Shortcuts: new Shortcuts tab in Settings lets you view all app shortcuts and remap them to your preferred key combinations; changes apply instantly to menus and persist across sessions
  • • Remote Branches in Branch Picker: branch picker now includes a Local/Remote tab bar to browse and switch to remote tracking branches alongside local ones
  • • Editable Skill Name: skill inspector Info tab now includes an editable Name field alongside Description, Version, and other metadata
  • • Allowed Tools Token Field: the Allowed Tools field in the skill inspector is now a token-based input; tools appear as purple removable chips with a text field to add new ones
  • • File Navigator Drag & Drop: drag files from external apps into the navigator to copy them into the target folder, or rearrange files within the tree to move them between directories; dropping onto a file targets its parent folder
  • • Root Drop Zone: files can now be dropped into the empty space below the file list to place them in the project root directory
  • • Smoother Folder Expansion: opening a folder for the first time no longer lags, since children load before the expansion animates
  • • Scroll Position Stability: the file navigator no longer jumps to the top after moving or copying files in large directories
  • • Reduced Flicker: file operations now trigger a single tree redraw instead of multiple, eliminating visual flicker
  • • Launch Greeting Animation: on every app launch, a centered splash window displays a time-of-day greeting (Good Morning/Afternoon/Evening) with the user's first name over an Apple Intelligence–style rainbow glow, then transitions smoothly into the main app window
  • • User Profile in Settings: new Profile section in General settings with First Name and Last Name fields, auto-populated from your macOS account name on first launch
  • • Improved Onboarding Glow: the Apple Intelligence rainbow blob effect in onboarding now spreads colors more evenly
Download v1.0.10

v1.0.9

Requires macOS 15.0

  • • Skills Manager: new sidebar tool to browse all Claude Code skills, displayed as a card grid with source badges (Global or project name) and file counts
  • • Skill Editor: live markdown editor with syntax highlighting for editing skill content and supporting pages directly in Admiral
  • • Skill Inspector: dedicated Info and Files tabs in the inspector panel for editing metadata and managing multi-file skills
  • • Create, Import, Clone, Delete: full skill lifecycle, including create from scratch, import from disk, clone to any location, or delete via toolbar and context menus
  • • Reorderable Tool Grid: drag and drop sidebar tools to customize their position; order persists across sessions
  • • Chat Scroll Fix: short threads now correctly pin to the bottom of the chat area, and the "Jump to Recent" button no longer stays visible when already at the bottom
  • • Project Overview: reactive chat lists, improved hygiene panels with empty states and prominent action buttons, and worktree cards with create-chat support
  • • Project Row: name now spans the full width of the sidebar row, with the ellipsis menu appearing only on hover, matching chat row behavior. Menu items now match the right-click context menu, with Open With moved between Import Session and Remove Project
Download v1.0.9

v1.0.8

Requires macOS 15.0

  • • Slash Commands: type / in chat input for autocomplete command suggestions
  • • Auto-Create Chat: new projects automatically get a chat created and selected
  • • Jump to Recent: quickly scroll to the latest messages in long conversations
  • • Improved Changes Tab: file rows now match the file navigator style with full-row click targets and hover highlights
  • • Scroll Fix: resolved an issue where the chat view could jump during table reload
  • • Terminal Cleanup: improved process tree cleanup for more reliable terminal session handling
  • • Branch Picker Refresh: fetch and update the list of available branches directly from the branch picker
  • • Prominent Create Branch: the new branch button is now a full-width primary button for easier access
  • • Archive Chats: archive chats instead of deleting them to keep your sidebar clean without losing content
  • • Archived Chats Settings: view, restore, or permanently delete archived chats from Settings
  • • Archived Chat Viewer: open archived chats in a standalone read-only window with full message history
  • • Chat Options Menu: ellipsis button in the toolbar for quick access to rename, archive, copy session ID, and fork into local branch or worktree
  • • Permission Shortcuts: approve (⌘Y), approve for session (⇧⌘Y), or deny (⌘D) permissions from anywhere, no focus required
  • • Enhanced Quick Search: ⌘K now searches message transcripts in addition to chat names; click a result to jump directly to the matching message with filter pills to narrow by chats or messages
  • • Copy Messages: hover over any user or assistant message to reveal a copy button for quick clipboard access
Download v1.0.8

v1.0.7

Requires macOS 15.0

  • • Chat Search: quickly find chats with Cmd+K quick open
  • • Action Buttons: replaced run commands with flexible project actions
  • • Ports Overview Tool: monitor active network ports from the sidebar
  • • Terminal Overview Tool: view running terminal sessions from the sidebar
  • • Anonymized App Analytics: opt-in telemetry via TelemetryDeck for usage insights
  • • Issues Form: submit feedback and report bugs directly from the Help menu
  • • Fetch & Pull Git Buttons: pull, fetch, and auto-fetch git changes from the toolbar
  • • Add/Delete Line Count: diff stats now shown in the Changes tab
  • • Permissions Shortcuts: keyboard shortcuts for approve/reject on permission requests
  • • Terminal Appearance Settings: independent light/dark mode setting for the terminal
  • • Settings Interface Update: tool visibility settings added to Preferences
  • • Closing Worktree Validation: warnings when deleting worktrees to prevent data loss
  • • Onboarding Animation Fix: resolved resource loading issue for the onboarding screen
Download v1.0.7

v1.0.6

Requires macOS 15.0

  • • Full menu bar with File, View, and Help menus with SF Symbol icons
  • • Keyboard shortcuts: New Chat (Cmd+T), Add Project (Cmd+Shift+N), Close Chat (Cmd+Shift+W), Toggle Sidebar (Cmd+S), Toggle Inspector (Cmd+Opt+I), Toggle Terminal (Cmd+Shift+T)
  • • Help menu with links to Website, Roadmap, Blog, and Donate
  • • Login sheet for Claude authentication
  • • File tree now preserves expansion state across refreshes and branch switches
  • • New branch creation from the branch picker
  • • Preferences window improvements
Download v1.0.6

v1.0.5

Requires macOS 15.0

  • • New About Admiral window with app info and links
  • • Roadmap link button added for easy access
  • • Visual feedback for git push operations in the inspector
  • • Reduced progress spinner size in the inspector
  • • Fixed an issue where the terminal could resize the main window
  • • Backwards compatibility with macOS 15 (Sequoia) and later
Download v1.0.5

v1.0.4

Requires macOS 26.2

  • • SwiftData stability fixes: named ModelConfiguration, activation policy timing, faulted message cleanup, and chat relationship consistency to prevent crashes
  • • Pasteboard crash fix: cached pasteboard types with TOCTOU guard and safer type checks before reading objects
  • • Thinking message deletion now removes from chat relationship before context deletion, avoiding dangling references
Download v1.0.4

v1.0.3

Requires macOS 26.2

  • • Git repository initialization from the Inspector panel when a project has no repo
  • • Remote management: add and remove git remotes via a new "Add Remote" sheet
  • • First push support with automatic upstream setup (push -u) when no tracking branch exists
  • • Fixed chat scroll-to-bottom reliability when switching between sessions
  • • Fixed header button layout: run options button spacing and icon updated from chevron to gear
Download v1.0.3

v1.0.2

Requires macOS 26.2

  • • Major chat performance improvements with cell reuse, height caching, and optimized memory usage
  • • Commit title generation state is now isolated per session
  • • Plan mode only captures content from actual plan files
  • • Filter faulted messages to prevent SwiftData crashes
  • • Improved spacing and sizing for buttons, inspector, and sidebar elements
Download v1.0.2

v1.0.1

Requires macOS 26.2

  • • Settings window with appearance and update preferences
  • • Concurrent chatting and performance improvements
  • • Unsent messages now persist with their chat thread
  • • Inspector plan mode is tied to the active chat
Download v1.0.1

v1.0

Requires macOS 26.2

  • • Initial release of Admiral
  • • Native macOS interface built on AppKit
  • • Claude Code integration with multi-chat support
  • • Built-in terminal with full ANSI support
  • • Git staging, commits, and side-by-side diffs
  • • Dark mode with hand-tuned color palette
  • • Keychain-native API key storage
Download v1.0