A native macOS app for managing Claude Code and Codex CLI sessions. Monitor sessions in real-time, run multiple terminals in parallel, preview diffs, create worktrees, launch multi-provider sessions, and more — all from a single hub.
Full screen mode
DemoAgentHub.mp4
Custom Theme
sentryTheme.mp4
Shortcuts
KeuboardShortcuts.mp4
- Multi-provider support — Monitor and launch Claude Code and Codex sessions side by side
- Real-time session monitoring — Watch all sessions update live via file-system watchers (no polling)
- Embedded terminal — Full PTY terminal (SwiftTerm) inside each monitoring card; resume or start sessions without leaving the app
- Hub panel — Unified view of all sessions across providers with single, list, 2-column, and 3-column grid layouts
- Resizable list cards — In list mode, monitoring cards can be resized with a preview guide for a smoother, less distracting resize experience
- Inline diff review — Full split-pane diff view with inline editor to send change requests directly to Claude
- File explorer and built-in editor — Browse the project tree, jump to files with Cmd+P, edit files in-app with syntax highlighting, and save changes without leaving AgentHub
- Git worktree management — Create and delete worktrees from the UI; launch sessions on new branches
- Remix with provider picker — Branch any session into an isolated git worktree and continue it in Claude or Codex; the original session's transcript is passed as context to the new session
- Multi-session launcher — Launch parallel sessions across Claude and Codex with manual prompts or AI-planned orchestration (Smart mode)
- Mermaid diagrams — Detects Mermaid diagram syntax in session output and renders it natively; diagrams can be exported as images
- Web preview — Auto-detects project type, starts dev servers for framework projects, and live-reloads static HTML
- iOS Simulator run destination — Build, install, and launch your app on any booted iOS Simulator directly from a session card; cancel at any phase (Building / Installing / Launching) via a stop button; boot-readiness check times out after 90 seconds to prevent hangs
- Plan view — Renders Claude-generated plan files with markdown and syntax highlighting; switch to Review mode to annotate individual lines and send batch feedback directly to Claude's interactive plan prompt
- Global search — Search across all session files with ranked results
- Usage stats — Track token counts, costs, and daily activity per provider (menu bar or popover)
- Command palette — Quick access to sessions, repositories, and actions via Cmd+K
- Pending changes preview — Review Edit/Write/MultiEdit tool diffs before accepting
- Custom themes — Ship with default and Sentry themes; load custom YAML themes with hot-reload
- Image & file attachments — Drag-and-drop files into sessions
- Session naming — Rename any session with custom names (SQLite-backed)
- Notification sounds — Configurable audio alert when a tool call awaits approval
- Privacy-first — Runs entirely on your machine; no data is collected or transmitted
Parallel execution with Claude Code and Codex
ParallelExecution.mp4
Plan view with inline review and batch feedback
PlanModeReview.mp4
Mermaid diagram rendering with image export
DiagramV2.mp4
AgentHub includes a built-in file explorer and editor for supported text files. Open the quick file picker with Cmd+P to jump directly to a file, then edit and save changes from inside the side panel without leaving the app.
File explorer, quick open, and built-in editor
FileEditor.mp4
- macOS 14.0+
- Claude Code CLI installed and authenticated
- Codex CLI installed (optional, for Codex features)
Download the latest release from GitHub Releases. The app is code-signed and notarized by Apple.
Updates are delivered automatically via Sparkle with EdDSA signature verification. You'll be prompted when a new version is available.
| Shortcut | Action |
|---|---|
| Cmd+K | Open command palette |
| Cmd+P | Quick open files |
| Cmd+N | New session |
| Cmd+B | Toggle sidebar |
| Cmd+, | Open settings |
| Cmd+[ | Navigate to previous session |
| Cmd+] | Navigate to next session |
| Cmd+\ | Toggle focus mode (single ↔ previous layout) |
| Cmd++ | Increase terminal font size |
| Cmd+- | Decrease terminal font size |
| Escape | Dismiss maximized card / side panel / sheet |
| Shortcut | Action |
|---|---|
| Return | Send inline comment to Claude |
| Cmd+Return | Add comment to review collection |
| Shift+Return | Insert newline in editor |
| Escape | Close inline editor or diff view |
| Shortcut | Action |
|---|---|
| Cmd+P | Open quick file picker |
| Cmd+S | Save current file in file editor |
| Escape | Close quick file picker or file editor |
| Shortcut | Action |
|---|---|
| Cmd+C | Copy selected text |
| Cmd+V | Paste |
| Cmd+A | Select all |
| ⌥↩ / ⌘↩ / ⇧↩ | Insert newline (configurable in Settings → Terminal) |
| Shortcut | Action |
|---|---|
| Up / Down | Navigate items |
| Return | Execute selected action |
| Escape | Close palette |
The monitoring panel supports multiple layout modes:
| Mode | Description |
|---|---|
| Single | One session at full size with optional side panel (diff, plan, web preview) |
| List | Vertical card list grouped by provider |
| 2-Column | Two-column grid |
| 3-Column | Three-column grid |
Any card can be maximized to full panel with a click (Escape to restore). In list mode, cards can be resized with a drag preview that commits on release.
| Status | Description |
|---|---|
| Thinking | Claude/Codex is processing |
| Executing Tool | Running a tool call |
| Awaiting Approval | Tool requires user confirmation |
| Waiting for User | Awaiting input |
| Idle | Session inactive |
Plan mode lets Claude read and analyze your codebase without executing any changes. Toggle it on or off with Shift+Tab inside the prompt editor in the multi-session launcher. When active, a teal indicator appears below the prompt.
| Provider | Behavior |
|---|---|
| Claude | Launched with --permission-mode plan; reads files and plans but does not write or execute |
| Codex | Not available — the Codex CLI has no flag to start in plan mode |
Why isn't Codex supported? Codex's plan mode (
ModeKind::Plan) is a TUI-only collaboration mode that can only be toggled interactively inside the running terminal. The CLI always starts in Default mode with no override flag. When plan mode is active in AgentHub, the Codex provider pill is disabled to avoid confusion. Track upstream support at openai/codex #12738.
AgentHub supports two display modes:
- Menu Bar Mode (default) — Stats appear in the system menu bar
- Popover Mode — Stats appear as a toolbar button in the app window
Toggle between modes in the app settings.
AgentHub reads Claude Code session data from:
~/.claude/projects/{encoded-path}/{sessionId}.jsonl
AgentHub reads Codex session data from ~/.codex/:
- Session files:
~/.codex/sessions/{date-path}/(JSONL format) - History file:
~/.codex/history.jsonl
Place YAML theme files in ~/Library/Application Support/AgentHub/themes/. Themes are hot-reloaded on save.
name: My Theme
version: 1
author: Your Name
colors:
brand:
primary: "#7C3AED"
secondary: "#6D28D9"
tertiary: "#5B21B6"
backgrounds:
dark: "#1A1A2E"
light: "#FFFFFF"- One PR per feature or bug fix. Each pull request should address a single, focused change.
- Keep PRs small. Small, reviewable diffs get merged faster and are easier to reason about.
- AI-generated code is welcome as long as the PR represents one cohesive feature or fix.
- Unrelated changes bundled together will not be reviewed or accepted. If you have multiple fixes, open separate PRs for each.
AgentHub runs entirely on your machine. It does not collect, transmit, or store any data externally. The app simply reads your local CLI session files to display their status.
MIT