Summary

Agent Viewer provides a web-based Kanban board for managing multiple Claude Code agents within tmux sessions. It allows users to spawn, monitor, and interact with AI agents from a unified interface, enhancing productivity for developers and researchers orchestrating AI workflows. The tool offers convenient access, including from mobile devices via Tailscale, simplifying complex agent management.

How It Works

This project creates a web UI that acts as a central dashboard for Claude Code agents. Agents are launched and managed within individual tmux sessions, with the Claude CLI facilitating their execution. Agent Viewer automatically detects these sessions, categorizing agents into 'Running', 'Idle', and 'Completed' columns on a Kanban board. This design enables real-time monitoring, direct messaging, and file uploads to agents, streamlining the development and deployment of AI-powered tasks.

Quick Start & Requirements

• Installation: Clone the repository, navigate to the directory, and run npm install.
• Prerequisites: Node.js (v18+), tmux, and the Claude CLI (claude command must be in the system's PATH).
• Running: Execute npm start. The server defaults to localhost:4200. Configuration for PORT and HOST is available via environment variables.
• Remote Access: Tailscale is recommended for accessing the UI from other devices, including mobile phones.

Highlighted Details

• Spawn new agents directly from the UI, each running in its own tmux session.
• Agents are visually organized into Kanban columns based on their operational state.
• Automatic discovery of pre-existing tmux sessions running Claude agents.
• View live agent output with full ANSI color support.
• Send messages and upload files to agents via the card interface.
• Re-spawn completed agents or attach to their tmux sessions for direct terminal interaction.

Maintenance & Community

The provided README does not contain information regarding maintainers, community channels (e.g., Discord, Slack), sponsorships, or a public roadmap.

Licensing & Compatibility

The README does not specify the software license. This lack of clarity may impact its suitability for commercial use or integration into proprietary projects.

Limitations & Caveats

The project's functionality is tightly coupled to the presence and correct configuration of Node.js, tmux, and the Claude CLI. The absence of a stated license is a significant adoption blocker, requiring clarification before use in sensitive environments. No specific bugs or platform limitations are detailed in the README.