Agent Management
Agent Management
Create, configure, and manage AI agents with role-based templates and lifecycle tools.
Agent Management
Reeve's agent management system lets you create, configure, and orchestrate multiple AI agents — each with its own role, workspace, model, and behavior. Agents are first-class entities with full lifecycle management.
What's an Agent?
An agent is a persistent AI identity with:
- Role — Defines behavior defaults (coordinator, manager, worker, research, assistant)
- Workspace — A directory with AGENTS.md, SOUL.md, TOOLS.md, MEMORY, and other context files
- Model — Which LLM powers the agent (Claude Opus, Sonnet, GPT-4, etc.)
- Channel bindings — Which messaging platforms the agent responds on
- Heartbeat — Periodic check-in schedule for autonomous work
- Subagent policy — Which other agents it can spawn
Agent Roles
Roles provide sensible defaults for different agent types:
| Role | Model | Heartbeat | Subagents | Session Reset | Use Case |
|---|---|---|---|---|---|
coordinator | Opus | 30m | All (*) | Never | Top-level orchestrator |
manager | Opus | 2h | Pipeline + self | 48h idle | Domain manager (marketing, eng) |
worker | Sonnet | None | Self only | 1h idle | Task execution |
research | Opus | 4h | Self only | 24h idle | Deep research, analysis |
assistant | Opus | 2h | Self only | 48h idle | General-purpose helper |
Roles are defined in config/role-defaults.js. When you create an agent with a role, these defaults are applied — but you can override any of them.
Quick Overview
# List all agents
reeve agents list
# Add a new agent
reeve agents add
# Inspect agent config + health
reeve agents inspect marketing-manager
# Health check with auto-fix
reeve agents doctor --fix
# Remove an agent
reeve agents delete old-workerArchitecture
Agent management spans several gateway components:
| Component | File | Purpose |
|---|---|---|
| Role defaults | config/role-defaults.js | 5 roles with model/heartbeat/subagent defaults |
| Scaffolding engine | agents/scaffolding.js | Creates workspace files from role templates |
| Config helpers | commands/agents.config.js | listAgentEntries, applyAgentConfig, buildAgentSummaries |
| CLI commands | commands/agents.commands.*.js | add, list, inspect, doctor, delete, identity |
| Bridge methods | gateway/server-bridge-methods-agents.js | JSON-RPC API for frontend |
| Templates | docs/reference/templates/roles/ | Role-specific AGENTS.md, SOUL.md, HEARTBEAT.md |