CLI Reference
reeve agents
CLI reference for `reeve agents` (list/add/delete/set identity)
reeve agents
Manage isolated agents (workspaces + auth + routing).
Related:
- Multi-agent routing: Multi-Agent Routing
- Agent workspace: Agent workspace
Examples
reeve agents list
reeve agents add work --workspace ~/reeve-work
reeve agents set-identity --workspace ~/reeve --from-identity
reeve agents set-identity --agent main --avatar avatars/reeve.png
reeve agents delete workIdentity files
Each agent workspace can include an IDENTITY.md at the workspace root:
- Example path:
~/reeve/IDENTITY.md set-identity --from-identityreads from the workspace root (or an explicit--identity-file)
Avatar paths resolve relative to the workspace root.
Set identity
set-identity writes fields into agents.list[].identity:
namethemeemojiavatar(workspace-relative path, http(s) URL, or data URI)
Load from IDENTITY.md:
reeve agents set-identity --workspace ~/reeve --from-identityOverride fields explicitly:
reeve agents set-identity --agent main --name "Reeve" --emoji "🐓" --avatar avatars/reeve.pngConfig sample:
{
agents: {
list: [
{
id: "main",
identity: {
name: "Reeve",
theme: "rooster",
emoji: "🐓",
avatar: "avatars/reeve.png"
}
}
]
}
}