$ tdb version
tdb v1.0.1 (built 2026-01-02)

$ tdb update
✓ Updated v1.0.1 → v1.0.2

$ tdb regions

$ tdb errors

tdb signup --email <email> --password <password> [--project <name>]

$ tdb signup --email [email protected] --password secret123 --project "Demo"

✓ Account created!
✓ API key saved to ~/.tenantsdb.json
Project ID: tdb_abc123

tdb login --email <email> --password <password>

tdb config set [--api-url <url>] [--api-key <key>]

$ tdb config show

KEY      VALUE
API URL  https://api.tenantsdb.com
API Key  tenantsdb_sk_a91de15...

tdb projects list [--json]

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "count": 2,
  "projects": [
    {
      "project_id": "tdb_2abf90d3",
      "name": "Healthcare SaaS",
      "api_key_count": 2,
      "created_at": "2026-01-17T20:12:06Z"
    },
    {
      "project_id": "tdb_43cd4942",
      "name": "E-commerce Platform",
      "api_key_count": 1,
      "created_at": "2026-01-17T20:12:24Z"
    }
  ]
}

tdb projects create --name <name>

tdb projects switch <project_id or name>

$ tdb projects switch tdb_43cd4942
✓ Switched to project 'E-commerce Platform' (tdb_43cd4942)

$ tdb projects switch "E-commerce Platform"
✓ Switched to project 'E-commerce Platform' (tdb_43cd4942)

tdb projects delete <project_id>

tdb apikeys list [--json]

tdb apikeys create [--name <name>]

tdb apikeys delete <key_id>

tdb workspaces list [--json]

tdb workspaces create --name <name> --database <type> --mode <mode>

$ tdb workspaces create --name myapp --database PostgreSQL --mode tenant
✓ Workspace 'myapp' created

# Control mode (no tenants, direct database access)
$ tdb workspaces create --name controlplane --database PostgreSQL --mode control
✓ Workspace 'controlplane' created

{
  "success": true,
  "http_status": 201,
  "code": "created",
  "id": "myapp",
  "blueprint": "myapp",
  "database": "PostgreSQL",
  "connection_string": "postgresql://tdb_2abf90d3:[email protected]:5432/myapp_workspace?sslmode=require"
}

tdb workspaces get <workspace_id> [--json]

tdb workspaces delete <workspace_id>

tdb workspaces query <workspace_id> --query <query>

$ tdb workspaces query myapp --query "SELECT * FROM accounts"

tdb workspaces schema <workspace_id> [--template <name>] [--json <json>] [--database <conn>]

$ tdb workspaces schema myapp --template fintech

tdb workspaces settings <workspace_id> [--json]

$ tdb workspaces settings myapp --json

tdb workspaces diff <workspace_id>

tdb workspaces import-analyze <workspace_id> \
  --host <host> --database <db> --user <user> --password <pass> \
  [--port 5432] [--type postgresql] [--routing-field tenant_id]

tdb workspaces import-data <workspace_id> \
  --host <host> --database <db> --user <user> --password <pass> \
  [--port 5432] [--type postgresql] [--routing-field tenant_id] \
  [--drop-routing true] [--create-tenants true]

tdb workspaces import-full <workspace_id> \
  --host <host> --database <db> --user <user> --password <pass> \
  [--port 5432] [--type postgresql] [--routing-field tenant_id] \
  [--drop-routing true] [--create-tenants true]

tdb workspaces import-status <workspace_id> --import-id <id>

tdb blueprints list [--json]

tdb blueprints get <blueprint_name> [--json]

tdb blueprints versions <blueprint_name>

tdb tenants create --name <name> --blueprint <blueprint> [--isolation <level>] [--region <zone>]

# Shared tenant (instant)
$ tdb tenants create --name acme --blueprint fintech
✓ Tenant 'acme' created

# Dedicated tenant in specific region
$ tdb tenants create --name acme --blueprint fintech --isolation 2 --region eu-central
✓ Tenant 'acme' created
⏳ Provisioning... (waiting for ready)

{
  "success": true,
  "http_status": 201,
  "code": "created",
  "tenant_id": "acme",
  "status": "ready",
  "databases": [
    {
      "blueprint": "fintech",
      "database_type": "PostgreSQL",
      "isolation_level": 1,
      "connection": {
        "database": "fintech__acme",
        "connection_string": "postgresql://tdb_2abf90d3:[email protected]:5432/fintech__acme?sslmode=require"
      }
    }
  ]
}

tdb tenants list [--json]

tdb tenants get <tenant_id> [--json]

tdb tenants delete <tenant_id> [--hard]

tdb tenants suspend <tenant_id>
tdb tenants resume <tenant_id>
tdb tenants restore <tenant_id>

tdb tenants migrate <tenant_id> --level <level> --blueprint <name> [--region <zone>]

# Upgrade to dedicated VM
$ tdb tenants migrate acme --level 2 --blueprint fintech

# Migrate to a different region
$ tdb tenants migrate acme --level 2 --blueprint fintech --region us-east

tdb tenants backup <tenant_id>
          tdb tenants backups <tenant_id>
          tdb tenants rollback <tenant_id> --path <path>

tdb tenants recover <tenant_id> --to <timestamp>

$ tdb tenants recover acme --to "2026-02-03T17:10:59Z"
✓ Recovery initiated
  ⚠️  Original VM preserved for 24h
      To undo: tdb tenants recover-undo acme

tdb tenants recover-undo <tenant_id>

$ tdb tenants recover-undo acme
✓ Recovery undone, original VM restored

tdb tenants deployments <tenant_id> [--json]

$ tdb tenants deployments acme --json

tdb tenants logs <tenant_id> [--type <error|slow>] [--since <1h|24h|7d>]

tdb tenants metrics <tenant_id> [--json]

tdb deployments list [--json]

tdb deployments create --blueprint <name> [--version <v>] [--all]

$ tdb deployments create --blueprint fintech --all

tdb deployments status <deployment_id>

tdb query --query <query> --blueprint <name> [--tenant <id>] [--all] [--type <type>]

# Query a single tenant
          $ tdb query --query "SELECT * FROM accounts" --blueprint fintech --tenant acme

          # Query all tenants
          $ tdb query --query "SELECT count(*) FROM users" --blueprint fintech --all

          # Insert data
          $ tdb query --query "INSERT INTO accounts (name, balance) VALUES ('Alice', 1000)" --blueprint fintech --tenant acme

          # Update data
          $ tdb query --query "UPDATE accounts SET balance = balance + 500 WHERE name = 'Alice'" --blueprint fintech --tenant acme