AgentHub

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.

Demo

<img width="1913" height="1079" alt="Hub" src="https://github.com/user-attachments/assets/99518d02-8ca6-458a-900c-bfd1f4e57419" />

Point to code

<img width="1911" height="1077" alt="Image" src="https://github.com/user-attachments/assets/f9e15c46-b907-4d7b-9b8e-f9dbcad06da4" />

Full screen mode

https://github.com/user-attachments/assets/c616c904-d165-4516-8478-afb810c13606

Custom Theme

https://github.com/user-attachments/assets/d4462101-a42b-446c-8491-9a4344539ac6

Shortcuts

https://github.com/user-attachments/assets/ee453a78-e417-488a-96c7-20732d1d1f60

Features

• 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.html first) 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

https://github.com/user-attachments/assets/c20c1f3e-745d-4a39-8599-37ad242b3ae6

Plan view with inline review and batch feedback

https://github.com/user-attachments/assets/b7661b65-dc58-4f8e-a4c5-df1e17a4076d

Mermaid diagram rendering with image export

https://github.com/user-attachments/assets/f6a304de-fc7c-4024-94c6-9e2222210dff

GitHub Support

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 Setup

GitHub features are optional, but any GitHub access in AgentHub depends on the GitHub CLI:

1. Install gh.
2. Authenticate with gh auth login.
3. Open any GitHub repository in AgentHub and use the GitHub action from the session UI.

File Explorer

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

https://github.com/user-attachments/assets/6d263d11-6648-42e7-9335-04aa51a33296

Requirements

• 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)

Installation & Updates

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.

Keyboard Shortcuts

| 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 |

Diff View

| 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 |

File Explorer

| Shortcut | Action | |---|---| | Cmd+P | Open quick file picker | | Cmd+S | Save current file in file editor | | Escape | Close quick file picker or file editor |

Embedded Terminal

| Shortcut | Action | |---|---| | Cmd+C | Copy selected text | | Cmd+V | Paste | | Cmd+A | Select all | | ⌥↩ / ⌘↩ / ⇧↩ | Insert newline (configurable in Settings → Terminal) |

Command Palette

| Shortcut | Action | |---|---| | Up / Down | Navigate items | | Return | Execute selected action | | Escape | Close palette |

Hub Layouts

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.

Session States

| 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

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.

Configuration

AgentHub's settings window is organized into three tabs:

• General —