CLI Reference
The Truss CLI follows the gh (GitHub CLI) convention. Every command group has subcommands for managing a specific domain.
Usage
truss <command> [subcommand] [options]
Global options
| Option | Description |
|---|
-V, --version | Output the version number |
-h, --help | Display help |
--json | Output as JSON (where supported) |
--limit <n> | Page size for list commands |
--page <n> | Page number for list commands |
Environment variables
| Variable | Description |
|---|
TRUSS_API_URL | Override the API base URL |
TRUSS_API_KEY | Override the API key |
Exit codes
| Code | Meaning |
|---|
| 0 | Success |
| 1 | General error |
| 2 | Authentication error |
Command groups
| Command | Description |
|---|
auth | Login, logout, and status |
org | Manage organizations and legal entities |
agent | Register, list, and manage agents |
mandate | Create, list, and manage mandates |
action | Record and list agent actions |
delegation | Manage delegation chains |
evidence | Create and manage evidence packages |
verify | Verify mandates, evidence, and signatures |
alert | Manage alerts and notification channels |
integration | Configure third-party integrations |
jurisdiction | Query regulations and obligations |
template | Manage mandate templates |
api | Make raw HTTP requests to the API |
config | View and edit CLI configuration |
completion | Generate shell completion scripts |