Agents

Agents are named AI profiles with their own description, identity, tool selection, and model preference.

List Agents

hlvm agent list

Create An Agent

hlvm agent add reviewer
hlvm agent identity reviewer --emoji R --color "#8A3FFC" \
  --description "Reviews diffs for correctness and release risk"

Use the agent in a one-shot task:

hlvm ask --agent reviewer "review the current diff"

Generate An Agent

hlvm agent generate "an agent that triages dependency update PRs"

Generation creates an editable agent file. Inspect it before trusting broad tool permissions.

Identity Options

hlvm agent identity can set the terminal emoji, color, GUI image, reusable pet avatar, description, and whether the agent is the default for unaddressed input. The current options are --emoji, --color, --image-url, --avatar, --description, --default, and --no-default.

Remove An Agent

hlvm agent remove reviewer

Removing an agent also removes its agent-specific memory.

Good Agent Design

Keep the description specific.
Restrict tools only when the agent needs a narrower surface.
Prefer model: auto unless the agent has a clear model requirement.
Put durable instructions in the agent file, not in one-off prompts.