Getting Started
Agent Manager lets you run multiple AI CLI agents in a single tabbed terminal, with messaging integration for approving actions from your phone. Get up and running in under a minute.
What is Agent Manager?
Agent Manager is a terminal UI application for managing multiple AI CLI agents in tabbed sessions. Run Claude Code and Gemini CLI side by side, get permission requests forwarded to Slack, Discord, or Telegram, and adopt standalone agents already running on your system — all from a single interface.
Built with Ink (React for CLIs), node-pty, and xterm-headless.
Quick Start
npm install -g agent-manager bash Then run it:
agent-manager bash
This opens a terminal UI with a tabbed interface. Press Ctrl+T to create a new session,
select an agent (Claude Code or Gemini CLI), enter a working directory, and start working.
Key Concepts
Sessions
Each agent runs in its own tab with a full PTY-backed terminal. Create, switch, and close sessions with keyboard shortcuts.
Connectors
Forward permission requests and agent responses to Slack, Discord, or Telegram. Approve actions from your phone.
Hooks
IPC-based lifecycle hooks bridge Claude Code events to the manager, enabling messaging integration.
Portals
Connect to running sessions from another terminal window. Full mirroring with input forwarding.