adjutant-agent

Adjutant

/ˈajət(ə)nt/ — noun, Military. An officer who assists a commanding officer with administrative duties, relays orders to the field, tracks unit readiness, and ensures every element of the force is accounted for and moving in concert.

---

In the 18th century, no army moved without its adjutant. While generals drew battle plans and captains led charges, the adjutant was the nerve center — the officer who knew where every regiment was, who was wounded, who was idle, and what orders hadn't reached the front yet. They kept the war diary. They dispatched riders. They turned chaos into coordination.

Adjutant does the same thing for your AI agents.

It is a real-time command post for multi-agent orchestration: a retro terminal-themed dashboard where you can watch your agents work, read their reports, assign them missions, and track every task from inception to completion. Agents connect via MCP, report status like field officers checking in at HQ, and communicate through persistent messaging channels — all backed by Beads issue tracking and a SQLite message store.

What it looks like in practice

┌─────────────────────────────────────────────────────────┐
│  ADJUTANT v2.x            ◉ 4 agents online   13:42:07 │
├──────────┬──────────────────────────────────────────────┤
│ AGENTS   │  kerrigan ● working  "API contract tests"   │
│          │  amon     ● working  "C4-002 storyboard"    │
│          │  mengsk   ◐ idle     "awaiting orders"      │
│          │  raynor   ○ offline                         │
├──────────┼──────────────────────────────────────────────┤
│ BEADS    │  adj-074  ██████░░░░  60%  API contracts    │
│          │  C4-002   █████████░  90%  Storyboard pipe  │
│          │  C4-003   ██░░░░░░░░  20%  Prompt enhance   │
├──────────┼──────────────────────────────────────────────┤
│ COMMS    │  [kerrigan] Phase 1 complete. 25 tests pass │
│          │  [amon] QA found 9 bugs, bugfix dispatched  │
│          │  [you] Roger. Prioritize the P1 fixes.      │
└──────────┴──────────────────────────────────────────────┘

Your agents are the army. You are the general. Adjutant keeps the war room running.

Table of Contents

• Quick Start
• Prerequisites
• Claude Code Plugin Setup
• Development Setup
• iOS App
• Features
• Architecture
• Configuration
• API Endpoints
• Remote Access
• Troubleshooting
• License

Quick Start

npm install -g adjutant
adjutant

The dashboard opens at http://localhost:4200.

CLI Options

adjutant                    # Start dashboard (frontend + backend + ngrok)
adjutant --no-tunnel        # Disable ngrok tunnel
adjutant --port 8080        # Custom frontend port (default: 4200)
adjutant --api-port 8081    # Custom backend port (default: 4201)
adjutant init               # Bootstrap Adjutant in a project
adjutant doctor             # Check system health and prerequisites
adjutant prime              # Output PRIME.md agent protocol to stdout
adjutant unhook             # Remove Adjutant plugin hooks from Claude Code
adjutant --help             # Show all options

One-time run without installing:

npx adjutant

Prerequisites

• Node.js 20+
• Beads installed with bd in PATH
• ngrok (optional, for remote access):

  brew install ngrok
  ngrok config add-authtoken <your-token>
  

Claude Code Plugin Setup

Adjutant integrates with Claude Code via its plugin system, providing MCP tools, epic planning, messaging skills, and automatic PRIME.md injection on session start.

First-time setup

After installing adjutant globally, run adjutant init in any project directory:

adjutant init

This performs the following:

Step	What it does
~/.adjutant/PRIME.md	Creates a global default agent protocol file
.adjutant/PRIME.md	Creates a local override in the current project
.mcp.json	Creates/merges MCP server config for adjutant
Plugin marketplace	Registers LupusDei/adjutant via claude plugin marketplace add
Plugin install	Installs adjutant-agent plugin with user scope
Plugin enable	Enables the plugin in Claude Code settings
Legacy cleanup	Removes old manual hooks from ~/.claude/settings.json

All steps are idempotent -- safe to run multiple times.

Verify installation

adjutant doctor

Checks file existence, plugin status, network health, and tool availability.

How it works

Once installed, the plugin automatically: