Overview
All AURA CLI command groups and common patterns.
Pre-alpha — not production ready
@aura-protocol/cli targets Solana devnet only. APIs and commands may change without notice. Do not use for real funds until a stable release and audit are published.
Every command supports the global flags (--rpc-url, --wallet, --program-id,
--json, --quiet, --dry-run, -y/--yes, --no-simulate, --no-color,
--compute-units). Commands that submit transactions require a wallet and run
through the secure pipeline; config, features, pda, ix list,
and ix schema run without one.
Ergonomic command groups
Friendly verbs for the highest-traffic flows:
| Group | Purpose |
|---|---|
config | Initialize and manage local CLI configuration |
treasury | Create, show, list, propose, pause, and cancel |
dwallet | Register and list dWallet references |
confidential | Encrypt deposits, guardrails, and confidential proposals |
execution | Execute, finalize, and watch pending proposals |
governance | Multisig, swarms, and override proposals |
Full instruction coverage
Beyond the ergonomic verbs, every instruction is reachable:
| Surface | Example |
|---|---|
| Generated per-domain commands | aura policy create-policy-template … |
Raw instruction surface (ix) | aura ix send transition_agent_state … |
The generated commands cover all 13 domains — including policy, budget,
operational, lifecycle, swarm, fees, address-lists, and batch. See
Generated Commands.
Utilities
| Group | Purpose |
|---|---|
ix (instruction) | Build, inspect, and send any IDL instruction directly |
pda | Derive any AURA, dWallet, or Encrypt PDA |
features | Inspect the program surface and maturity breakdown |
dashboard | Live terminal treasury dashboard |
Automation Pattern
Use --json for scripts and CI, --yes to skip confirmations, and --dry-run
to inspect a built instruction without sending it.
# Inspect the program surface as JSON
aura features --json
aura ix list --json
# Show treasury state as JSON
aura treasury show --agent-id agent-1 --json
# Dry-run a proposal (preview only, no send)
aura treasury propose --agent-id agent-1 --amount 250 --chain ethereum \
--recipient 0xdeadbeef... --dry-run
# Non-interactive governance change in CI
aura --yes --json governance multisig --agent-id agent-1 --required 2 --guardians pk1,pk2,pk3