agent-manager

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.

Next Steps