@tensflare/cli

Truss CLI — the official command-line tool for the Truss trust infrastructure API. Modeled after gh (GitHub CLI).

What is Truss?

Truss is an accountability layer for AI agents — it records every agent action as a cryptographically signed, tamper-evident audit trail. Learn more →

Installation

npm install -g @tensflare/cli

Or run directly via npx:

npx @tensflare/cli

Quick start

# 1. Authenticate
truss auth login

# 2. List agents
truss agent list

# 3. Create a mandate
truss mandate create --agent-id agt_001 --scope '{"permitted_actions":["read"]}'

# 4. Record an action
truss action record --mandate-id mnd_001 --action-type read

# 5. Generate evidence
truss evidence generate --mandate-id mnd_001

Command reference

| Command | Description | |---|---| | truss auth login | Authenticate with the Truss API | | truss org list | List organizations | | truss agent list | List registered agents | | truss agent create | Register a new agent | | truss mandate list | List mandates | | truss mandate create | Create a new mandate | | truss action record | Record an action | | truss action list | List action records | | truss delegation create | Create a delegation hop | | truss evidence generate | Generate evidence package | | truss verify package | Verify evidence integrity | | truss alert list | List alerts | | truss integration list | List integrations | | truss jurisdiction evaluate | Evaluate regulatory obligations | | truss template list | List mandate templates | | truss api <method> <path> | Raw API access (like gh api) | | truss config list | Show current configuration | | truss completion | Generate shell completion script |

Run truss --help for global options or truss <command> --help for per-command flags.

Configuration

Config is stored at ~/.config/truss/config.json. Environment variables override:

export TRUSS_API_URL="https://api.truss.tensflare.com"
export TRUSS_API_KEY="tr_abc123"

Features

• 15 command groups covering the full Truss API
• --json output for piping to jq and other tools
• Pagination via --limit and --page
• Shell completions for bash, zsh, and fish
• Raw API access with truss api GET /agents
• Auth via config file or environment variables

Related packages

| Package | Description | |---|---| | @tensflare/tap | Core Zod schemas for mandates, actions, and delegations | | @tensflare/truss-sdk | TypeScript SDK for programmatic access |

Development

npm install
npm run build
# Run locally:
node dist/index.js

Contributing

Pull requests are welcome. Please see the contribution guidelines.

License

Apache 2.0 — see LICENSE.