A native macOS app for managing Claude Code and Codex CLI sessions. Monitor sessions in real-time, run multiple terminals in parallel, preview diffs, browse GitHub pull requests and issues, 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
- Auxiliary Hub shell — Toggle a session-scoped shell dock from the Hub with Cmd+J; it follows the selected session's worktree and preserves shell state per session
- 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
- GitHub support — Browse pull requests and issues for the current repository, inspect PR diffs and CI checks, and send GitHub context back into a session
- 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 — Prefers agent-started localhost servers, recovers recent localhost URLs from session files when needed, and falls back to static HTML (
index.htmlfirst) when no live preview is available - Web preview context mode — Inspect and select elements in the live web preview, queue multiple selections, and attach them as structured context (HTML, CSS selectors, computed styles) to your next terminal message — no copy-paste needed
- 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
- Process cleanup — When a monitored Hub card is removed, AgentHub terminates both the card terminal and the auxiliary Hub shell process tree so shell/CLI sessions are not left orphaned
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 can surface repository GitHub data directly inside the app through the GitHub CLI. GitHub access in AgentHub requires gh to be installed and authenticated.
- Browse pull requests and issues for the active repository
- Open the current branch PR directly from the session card
- Review PR overview content, changed files, CI checks, and comments
- Render PR file diffs with the same inline diff viewer used elsewhere in AgentHub
- Send PR or issue context back into the active Claude Code or Codex session
GitHub features are optional, but any GitHub access in AgentHub depends on the GitHub CLI:
- Install
gh. - Authenticate with
gh auth login. - Open any GitHub repository in AgentHub and use the
GitHubaction from the session UI.
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)
- GitHub CLI installed and authenticated (optional overall, required for GitHub access/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+J | Toggle Hub auxiliary shell |
| 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