agent-viewer

Agent Viewer

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

Prerequisites

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

Install prerequisites (macOS)

Setup

Usage

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

Configuration

Example:

Remote Access via Tailscale

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

1. Install Tailscale on your Mac

Or download from tailscale.com/download.

2. Install Tailscale on your phone

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

3. Start the server

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

4. Open on your phone

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

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

Features

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