`hiveloom agent`

The primary command for managing agent definitions. Each agent is a named, versioned bundle of: a system prompt, a model selection, a credential, and optional capabilities (skills) and chat-surface bindings.

Synopsis


hiveloom agent [GLOBAL FLAGS] <COMMAND>

Global flags

Flag	Default	Description
`--tenant <TENANT>`	`default`	Target tenant.
`--endpoint <URL>`	—	API endpoint.
`--token <TOKEN>`	—	Bearer token for remote access.
`--json`	—	JSON output.

Subcommands

Subcommand	Purpose
`create`	Create a new agent.
`list`	List agents in the tenant.
`show`	Show one agent (system prompt, model, capabilities).
`edit`	Edit an existing agent in `$EDITOR`. Bumps the version.
`delete`	Delete an agent.
`versions`	List historical versions for an agent.
`rollback`	Roll an agent back to a previous version.
`export`	Export the agent definition as a YAML manifest.
`reflect`	Trigger agent self-reflection (placeholder).
`bind`	Bind the agent to a chat surface.
`compaction`	View or update the agent’s compaction config.

Run hiveloom agent <subcommand> --help for arguments.

Examples

Create an agent and verify:


hiveloom agent create \
  --name pirate \
  --model anthropic:claude-sonnet-4-6 \
  --credential anthropic-default \
  --system "Reply only in pirate-speak."
hiveloom agent list

Show the full definition:


hiveloom agent show pirate --json

Edit and roll back if it goes wrong:


hiveloom agent edit pirate          # opens $EDITOR; bumps version
hiveloom agent versions pirate      # lists v1, v2, ...
hiveloom agent rollback pirate v1

Export for source control or to recreate elsewhere:


hiveloom agent export pirate > pirate.yaml
hiveloom apply --file pirate.yaml --tenant acme

Versioning

Every edit (or apply of a changed manifest) creates a new version of the agent and atomically promotes it. rollback switches the active version pointer; older versions are retained until they are explicitly purged.

hiveloom agent