truss agent
Manage AI agents — register, list, inspect, update status, rotate keys, and set behavior baselines.
Subcommands
truss agent list
List registered agents.
| Option | Description |
|---|---|
-l, --limit <n> | Page size (default: 50) |
-p, --page <n> | Page number (default: 1) |
--json | Output as JSON |
truss agent list
truss agent list -l 100 -p 2
truss agent list --json
truss agent get <agent-id>
Get agent details — ID, name, description, framework, runtime, status, public key, created date, and mandate count.
| Option | Description |
|---|---|
--json | Output as JSON |
truss agent get agt_abc123
truss agent get agt_abc123 --json
truss agent create <name> <public-key>
Register a new agent.
| Option | Description |
|---|---|
--description | Human-readable agent description |
--framework | Agent framework (e.g. langgraph, crewai, autogen) |
--runtime | Agent runtime (e.g. node, python) |
truss agent create "SupportBot" "ssh-ed25519 AAAAC3..."
truss agent create "DocAgent" "ecdsa-sha2-nistp256 AAAA..." --description "Document processing agent" --framework langgraph --runtime python
truss agent status <agent-id> <status>
Change agent status.
| Option | Description |
|---|---|
--reason | Reason for the status change |
Valid statuses: active, suspended, deregistered.
truss agent status agt_abc123 suspended --reason "Security review in progress"
truss agent status agt_abc123 active
truss agent status agt_abc123 deregistered --reason "Agent decommissioned"
truss agent keys <agent-id>
Show key rotation history for an agent.
| Option | Description |
|---|---|
--json | Output as JSON |
truss agent keys agt_abc123
truss agent keys agt_abc123 --json
truss agent baseline <agent-id>
Get or update behavior baseline for an agent.
| Option | Description |
|---|---|
--action-types | Comma-separated allowed action types |
--avg-input-size | Expected average input size in bytes |
--avg-output-size | Expected average output size in bytes |
--peak-hours | Comma-separated peak hour ranges (e.g. 09:00-12:00,14:00-17:00) |
--update | Persist the baseline values (without this flag, values are shown as a diff) |
truss agent baseline agt_abc123
truss agent baseline agt_abc123 --action-types read,write,query --avg-input-size 4096 --avg-output-size 8192 --peak-hours "09:00-17:00" --update