Summary

AgentHub is a native macOS application designed to streamline the management of Claude Code and Codex CLI sessions. It targets developers and researchers using these AI coding assistants, offering a centralized hub for real-time monitoring, parallel execution, and integrated editing workflows, thereby enhancing productivity and simplifying complex AI-assisted development tasks.

How It Works

This application provides a unified interface for multiple AI coding sessions, leveraging file-system watchers for real-time, non-polling session updates. Core features include an embedded PTY terminal, flexible hub panel layouts, and an inline diff review system with an integrated editor for direct change requests. It supports Git worktree management, allowing sessions to be branched into isolated environments with context preservation. Novel capabilities include native rendering and export of Mermaid diagrams, direct iOS Simulator integration for app deployment, and a "Plan" mode for code analysis without execution. The architecture emphasizes privacy, running entirely locally without data transmission.

Quick Start & Requirements

• Installation: Download the latest release from GitHub Releases.
• Prerequisites: macOS 14.0+, Claude Code CLI (installed and authenticated), Codex CLI (optional, for full features).
• Documentation: Keyboard shortcuts and layout modes are detailed within the README.

Highlighted Details

• Multi-provider support for Claude Code and Codex CLI sessions.
• Real-time session monitoring via file-system watchers.
• Integrated inline diff review with an in-app editor.
• Git worktree management and session branching with context transfer.
• Native Mermaid diagram rendering and export.
• Direct iOS Simulator integration for build, install, and launch workflows.
• "Plan" mode for code analysis without execution.
• Privacy-first design: runs entirely locally, no data transmitted.

Maintenance & Community

The project outlines contribution guidelines emphasizing small, focused pull requests for features or bug fixes. No specific community channels (e.g., Discord, Slack) or roadmap details are provided in the README.

Licensing & Compatibility

• License: MIT.
• Compatibility: The MIT license permits commercial use and integration with closed-source projects.

Limitations & Caveats

Codex CLI's "plan mode" is not supported due to limitations in the CLI's design, with the Codex provider pill being disabled when this mode is active in AgentHub. The application requires macOS 14.0 or later.