🚧 SanctumAI is in beta. APIs may change before v1.0.
CLI Referencesanctum agent

sanctum agent

Manage AI agent identities.

Subcommands

register

Register a new agent with a unique Ed25519 keypair.

sanctum agent register <name> [--description <text>]
sanctum agent register cursor-agent --description "Cursor AI editor"
βœ… Agent 'cursor-agent' registered
   Identity: Ed25519 keypair generated
   Public key: dwP8...k4Fm
   Config written to: ~/.sanctum/agents/cursor-agent/

list

List all registered agents.

sanctum agent list
β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”
β”‚ Name           β”‚ Description          β”‚ Registered          β”‚
β”œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”Όβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€
β”‚ cursor-agent   β”‚ Cursor AI editor     β”‚ 2026-02-10 23:18:00 β”‚
β”‚ claude-code    β”‚ Claude Code          β”‚ 2026-02-11 10:00:00 β”‚
β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”΄β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

remove

Deregister an agent and revoke all its active leases.

sanctum agent remove <name>
sanctum agent remove cursor-agent
⚠️  This will revoke all active leases for 'cursor-agent'.
Continue? [y/N] y
βœ… Agent 'cursor-agent' removed

Notes

  • Agent names support alphanumeric characters, hyphens, and underscores
  • Removing an agent immediately revokes all active leases and deletes the keypair
  • Agent names are used in policy principal fields with glob patterns (e.g., agent:cursor-*)