CLI Reference: Agent Store (`agent`)

Commands for managing the agent install store: installing, listing, running, and removing agent definitions.

`ash agent install`

Install (register) an agent definition in agentd's Agent Store.

ash agent install <manifest> [--dir <path>]

Argument/Flag	Description
`manifest`	Path to the agent manifest YAML file
`--dir`	Install directory; defaults to `/var/lib/scarab-runtime/agents/<name>`

Example:

ash agent install etc/agents/report-agent.yaml \
  --dir /opt/agents/report-agent

List all installed agents in the Agent Store.

ash agent list
ash agent ls   # alias

Output columns: NAME, VERSION, RUNTIME, INSTALL DIR, INSTALLED AT.

Remove an installed agent definition.

ash agent remove <name>

Does not affect running instances. Use ash kill <agent-id> to stop running agents first.

Spawn an installed agent by name.

ash agent run <name> [--task <text>]

Argument/Flag	Description
`name`	Agent name as registered via `ash agent install`
`--task`	Override `spec.task` for this run; sets `SCARAB_TASK` env var

Examples:

ash agent run report-agent

ash agent run report-agent \
  --task "Generate Q4 2026 financial summary"

Returns the spawned agent ID.

Print a Markdown capability sheet for a manifest file.

ash agent capability-sheet <manifest>

Does not require agentd to be running. Renders a human-readable table of:

Useful for security review before installing or spawning an agent.

Example:

ash agent capability-sheet etc/agents/report-agent.yaml