CLI Reference

This page reflects @ai-setu/cli v0.16.1 — generated straight from running ai-setu --help, so it can't drift from what the installed CLI actually prints.

ai-setu — control-plane CLI for AI Setu tenants

Install

npm i -g @ai-setu/cli          # exposes the `ai-setu` command
export AI_SETU_PAT=tt_pat_…
export AI_SETU_TENANT_ID=00000000-0000-0000-0000-000000000001
ai-setu balance

Or run it without installing:

npx @ai-setu/cli --help

Usage: ai-setu <command> <subcommand> [options]

For inference (chat, embeddings) use @ai-setu/client instead — this CLI is the control-plane surface (workspaces, keys, billing, PATs, BYOK Connections).

Commands

balance

ai-setu balance

Show current credit balance

usage

ai-setu usage

Show spend projection (avg/day, MTD, month-end)

workspaces

ai-setu workspaces list

List workspaces

ai-setu workspaces create --name=<n> [--slug=<s>]

Create a workspace

keys

ai-setu keys list --workspace=<id>

List API keys in a workspace

ai-setu keys create --workspace=<id> --name=<n>

Mint a new API key (secret shown ONCE)

ai-setu keys rotate --id=<id>

Rotate a key (new secret shown ONCE)

ai-setu keys revoke --id=<id>

Revoke a key

topup

ai-setu topup --amount-usd=<n>

Create a Stripe top-up intent

pats

ai-setu pats list

List your Personal Access Tokens

ai-setu pats create --name=<n> [--scope=admin:read] [--scope=admin:write] [--expires-in-days=<n>]

Mint a new PAT (secret shown ONCE)

ai-setu pats revoke --id=<id>

Revoke a PAT

connections

ai-setu connections list

List BYOK Connections (@<slug>/<model>)

ai-setu connections add --provider=<p> --slug=<s> --key=<k> [--base-url=<u>] [--workspace=<id>] [--default-model=<m>] [--daily-cap-usd=<n>] [--organization=<o>] [--azure-deployment=<d> --azure-api-version=<v>] [--aws-access-key-id=<k> --aws-secret-access-key=<k> --aws-region=<r>] [--gcp-service-account-json=<json> --vertex-region=<r> --vertex-project=<p>]

Add/update a Connection (Credential + slug)

ai-setu connections test --id=<id>

Probe a Connection's upstream credential

ai-setu connections revoke --id=<id>

Revoke a Connection (+ its Credential)

Global flags

--tenant-id=<uuid> — Tenant id (defaults to AI_SETU_TENANT_ID env var)
--base-url=<url> — API base URL (defaults to AI_SETU_API_BASE_URL or https://api.aisetu.ai)
--format=json|table — Output format (default: table; piped output: json)
--help, -h — Show this help

Environment variables

AI_SETU_PAT — Required. Personal Access Token.
AI_SETU_TENANT_ID — Recommended. Tenant id for billing / usage commands.
AI_SETU_ENV — Optional. production (default) | staging → api.staging.aisetu.ai.
AI_SETU_API_BASE_URL — Optional. Full API URL override (self-host); wins over AI_SETU_ENV.

Mint a PAT from https://app.aisetu.ai/settings/profile (Personal Access Tokens panel) or via the OTP signup MCP tool.

On this page