Attestify OS — CLI

The Attestify CLI provides command-line access to the core Attestify OS operations: init, run, receipt lookup, and diagnostics.

Commands

| Command | What it does | |---|---| | attestify init | Check env vars and verify API connectivity | | attestify run | Execute a governed agent run | | attestify receipt <runId> | Retrieve and display a signed receipt | | attestify doctor | Diagnose configuration and connectivity | | attestify policy check | Check a policy rule (Phase 4) | | attestify pay | Pay-per-call via x402 (Phase 4) |

Quick start

# Run directly
npx ts-node cli/attestify.ts init

# Or install globally (once published — see the repo's own publish checklist)
npm install -g attestify
attestify init

Examples

# Check configuration
attestify doctor

# Execute a run
attestify run --action example.echo --input '{"message":"hello"}'

# Get a receipt
attestify receipt 550e8400-e29b-41d4-a716-446655440000

# Output raw JSON
attestify run --action example.echo --json

# Use a specific API key
attestify run --action example.echo --key atst_abc123...

# Use a different base URL (local dev)
attestify run --action example.echo --url http://localhost:3000

Environment variables

ATTESTIFY_API_KEY         Required for all commands
ATTESTIFY_BASE_URL        Optional. Default: https://www.attestifyos.com
NEXT_PUBLIC_SUPABASE_URL  Checked by doctor
NEXT_PUBLIC_SUPABASE_ANON_KEY  Checked by doctor

See .env.example for the complete variable reference.