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

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
• Inline diff review — Full split-pane diff view with inline editor to send change requests directly to Claude
• Git worktree management — Create and delete worktrees from the UI; launch sessions on new branches
• Multi-session launcher — Launch parallel sessions across Claude and Codex with manual prompts or AI-planned orchestration (Smart mode)
• Web preview — Auto-detects project type, starts dev servers for framework projects, and live-reloads static HTML
• Plan view — Renders Claude-generated plan files with markdown and syntax highlighting
• 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

Requirements

• macOS 14.0+
• Claude Code CLI installed and authenticated
• Codex CLI installed (optional, for Codex 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+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)
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

Embedded Terminal

Shortcut	Action
Cmd+C	Copy selected text
Cmd+V	Paste
Cmd+A	Select all

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

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

Configuration

Display Mode

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.

Session Data

AgentHub reads Claude Code session data from:

~/.claude/projects/{encoded-path}/{sessionId}.jsonl

Codex Data

AgentHub reads Codex session data from ~/.codex/:

• Session files: ~/.codex/sessions/{date-path}/ (JSONL format)
• History file: ~/.codex/history.jsonl

Custom Themes

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"

Contributing

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

Privacy

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.

License

MIT