A kanban board for managing multiple Claude Code agents running in tmux sessions. Spawn, monitor, and interact with agents from a single web UI.

Manage your agents from your mobile phone with Tailscale

• Node.js (v18+)
• tmux
• Claude CLI (claude command available in your PATH)

brew install node tmux
npm install -g @anthropic-ai/claude-code

git clone <repo-url> && cd agent-viewer
npm install

npm start

Open http://localhost:4200 in your browser.

Example:

HOST=0.0.0.0 PORT=3000 npm start

You can access Agent Viewer from your phone (or any device) by using Tailscale.

brew install tailscale

Or download from tailscale.com/download.

Download the Tailscale app from the App Store or Google Play. Sign in with the same account.

npm start

The server binds to 0.0.0.0 by default, so it's already accessible on all network interfaces including Tailscale.

Find your Mac's Tailscale IP (shown in the Tailscale app or via tailscale ip), then visit:

http://<tailscale-ip>:4200

If you have MagicDNS enabled, you can use your machine name instead:

http://<machine-name>:4200

• Spawn agents — Click [+ SPAWN] or press N, enter a project path and prompt. Each agent launches in its own tmux session running claude.
• Kanban columns — Agents are sorted into Running, Idle, and Completed columns based on their state.
• Auto-discovery — Existing tmux sessions running Claude are automatically detected and added to the board.
• Live output — Click VIEW OUTPUT to see the full terminal output with ANSI color rendering.
• Send messages — Type in the prompt field on any card and press Ctrl+Enter to send follow-up messages to an agent.
• File uploads — Drag and drop files onto a card or click FILE to send files to an agent.
• Re-spawn — Completed agents can be re-spawned with a new prompt from the same project directory.
• Attach — Click ATTACH to copy the tmux attach command for direct terminal access.