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