Skip to content

cvsloane/agent-commander

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

578 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Agent Commander

CI License: MIT GitHub release Node.js Go PRs Welcome

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).

Command Center UX

  • Fleet-to-terminal landing/ combines fleet health, the host roster, tmux windows and panes, and a persistent live terminal
  • Structured tmux control — create, rename, and close windows; split, zoom, select, and terminate panes
  • Focused intervention — use the prompt composer and terminal attention overlay without leaving the active pane
  • Fast navigation — launch or reopen work, add hosts, and search routes, sessions, and actions from the command palette

Screenshots

Dashboard Overview

More screenshots
Sessions Approvals
Sessions Approvals
Session Detail Visualizer
Session Detail Visualizer

Settings

Quick Start

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

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, then start the dev servers (stays in the foreground):

pnpm db:migrate
pnpm dev

Features

  • Command Center — work from / with fleet context, windows-first navigation, and inline terminal control
  • tmux-native sessions — discover and manage real tmux panes across hosts
  • Interactive console — persistent live streaming, searchable scrollback and history, full terminal control, and read-only viewers
  • Multi-terminal workspace — use two panes side by side on desktop or quick-switch on compact layouts
  • Orchestrator + approvals — attention queue for input, approvals, and errors
  • Autonomous agents — scheduled or manual orchestrators and workers with runtime reuse, preflight, and governance
  • Scoped memory — repo and global memory for every session, with procedural knowledge and trajectory-backed learning
  • Hermes-ready integration — service-auth wake triggers, webhook wakes, governance summaries, and external scheduler support
  • Unified launch — start new provider sessions, repeat recent launches, or open existing panes
  • Visualizer — immersive full-screen activity view
  • Search + analytics — global search and usage tracking
  • Alerts — browser, audio, in-app toasts, and OpenClaw notifications
  • Multi-host — one dashboard for many machines

Documentation

Guide Description
Docs Index Full documentation map
Overview Concepts and workflows
Command Center Fleet, tmux, terminal, launch, palette, and shortcuts
Releases Public release notes and milestones
Getting Started Install and run locally
Tmux Workspace Window and pane management in the Command Center
Sessions Session lifecycle and actions
Console Streaming Interactive tmux in the browser
Orchestrator Attention queue and summaries
Automation and Memory Autonomous runs, work queue, and scoped memory
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

Architecture Diagram

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
  • GET /v1/repos, GET /v1/memory/search, POST /v1/memory
  • GET /v1/automation-agents, POST /v1/automation-agents/:id/wake
  • GET /v1/automation-agents/:id/preflight
  • GET /v1/automation-runs, GET /v1/automation-runs/:id/events, GET /v1/automation-wakeups
  • GET /v1/governance-approvals, POST /v1/governance-approvals/:id/decide
  • GET /v1/work-items, POST /v1/work-items
  • 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.

About

Mission control for tmux-native AI agent sessions with live streaming, approvals, and multi-host orchestration.

Topics

Resources

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Used by

Contributors

Languages