Agent Commander

Agent Commander is a mission-control dashboard for managing AI agent sessions across multiple hosts. It combines a Next.js dashboard, a Fastify control plane, and a Go-based agent daemon (agentd).

Screenshots

More screenshots

Sessions	Approvals

Session Detail	Visualizer

Quick Start

git clone https://github.com/cvsloane/agent-commander.git
cd agent-commander
pnpm install
pnpm dev

Copy and update environment files:

cp services/control-plane/.env.example services/control-plane/.env
cp apps/dashboard/.env.example apps/dashboard/.env

Run migrations:

pnpm db:migrate

Features

• tmux-native sessions — discover and manage real tmux panes across hosts
• Interactive console — live streaming with full terminal control and read-only viewers
• Orchestrator + approvals — attention queue for input, approvals, and errors
• Session generator — spawn multi-session templates with groups and links
• Visualizer — immersive full-screen activity view
• Search + analytics — global search and usage tracking
• Alerts — browser, audio, in-app toasts, Clawdbot
• Multi-host — one dashboard for many machines

Documentation

Guide	Description
Docs Index	Full documentation map
Overview	Concepts and workflows
Getting Started	Install and run locally
Sessions	Session lifecycle and actions
Console Streaming	Interactive tmux in the browser
Orchestrator	Attention queue and summaries
Approvals	Permission requests and decisions
Coolify Deployment	Production setup on Coolify + Cloudflare
API Reference	REST + WS endpoints
Security	Security best practices

Public site:

• Feature site (apex) + docs site: docs/deployment-coolify.md

Architecture

API Reference (Summary)

• GET /v1/sessions, POST /v1/sessions/:id/commands
• GET /v1/approvals, POST /v1/approvals/:id/decide
• GET /v1/hosts, POST /v1/hosts
• POST /v1/notifications/test

Security

• Set strong JWT_SECRET and NEXTAUTH_SECRET
• Use HTTPS in production
• Store secrets in a secret manager
• Rotate tokens on exposure

See SECURITY.md for reporting vulnerabilities.

License

MIT

Development Status

See project_status.md for recent development activity and context.