Commands

Complete reference for all Sazabi CLI commands. Run any command with --help to see available options.

Global flags

These flags work with all commands:

auth

Manage authentication credentials.

auth login

Authenticate via browser using OAuth device flow.

sazabi auth login

Opens your default browser to complete authentication. After logging in, your credentials are stored locally for future commands.

auth save

Save an existing bearer token or API key to the active profile.

sazabi auth save <token>

auth logout

Remove saved credentials from the active profile.

sazabi auth logout

auth whoami

Display current authentication context and active selections.

sazabi auth whoami

Shows:

• Credential type (user token, secret key, or partner key)
• Authenticated user or key name
• Active organization and project
• Source of each credential (flag, environment, or settings)

profiles

Manage named CLI profiles for multi-environment configuration.

profiles list

List all configured profiles.

sazabi profiles list

profiles use

Set the active profile.

sazabi profiles use <name>

profiles create

Create a new empty profile.

sazabi profiles create <name>

profiles delete

Delete a profile. Cannot delete the active profile.

sazabi profiles delete <name>

organizations

Manage organizations.

organizations list

List organizations available to the current credential.

sazabi organizations list

organizations use

Set the active organization for future commands.

sazabi organizations use <organization-id>

organizations rename

Rename the active organization.

sazabi organizations rename <name>

projects

Manage projects.

projects list

List projects in the active organization.

sazabi projects list

projects use

Set the active project for future commands.

sazabi projects use <project-id>

members

Manage organization members.

members list

List members in the active organization.

sazabi members list

members update-role

Update a member's organization role.

sazabi members update-role <user-id> --role <role>

members remove

Remove a member from the active organization.

sazabi members remove <user-id>

public-keys

Manage public API keys. Public keys are project-scoped and used for log ingestion.

public-keys list

List public keys in the active project.

sazabi public-keys list

public-keys get

Get details for a specific public key.

sazabi public-keys get <key-id>

public-keys create

Create a new public key.

sazabi public-keys create <name>

public-keys update

Update a public key.

sazabi public-keys update <key-id> --name "New name"

public-keys delete

Delete a public key.

sazabi public-keys delete <key-id>

secret-keys

Manage secret API keys. Secret keys are organization-scoped and provide full API access.

secret-keys list

List secret keys in the organization.

sazabi secret-keys list

secret-keys get

Get details for a specific secret key.

sazabi secret-keys get <key-id>

secret-keys create

Create a new secret key.

sazabi secret-keys create <name>

secret-keys update

Update a secret key.

sazabi secret-keys update <key-id> --name "New name"

secret-keys delete

Delete a secret key.

sazabi secret-keys delete <key-id>

logs

Stream and forward logs.

logs tail

Stream logs from the current project in real-time via WebSocket.

sazabi logs tail

Examples:

# Tail all logs
sazabi logs tail

# Tail only errors and warnings
sazabi logs tail --severities ERROR,WARN

# Tail specific services
sazabi logs tail --services api,worker

# Tail with search filter
sazabi logs tail --search "database"

# Output as JSON (for piping)
sazabi logs tail --json

logs forward

Forward plaintext logs from stdin or file to the current project.

# From stdin
echo "Log message" | sazabi logs forward

# From file
sazabi logs forward --file app.log

# Follow file (like tail -f)
sazabi logs forward --file app.log --follow

threads

Manage agent threads.

threads list

List threads from the current project.

sazabi threads list

threads get

Get a thread with its messages.

sazabi threads get <thread-id>

threads search

Search threads in the current project.

sazabi threads search <query>

messages

Send, list, and search messages.

messages send

Send a message to a thread. Creates a new thread if --thread-id is omitted.

sazabi messages send <message>

Examples:

# Start a new thread
sazabi messages send "What errors are happening in production?"

# Continue existing thread
sazabi messages send "Show me the stack traces" --thread-id abc123

# Wait for response
sazabi messages send "Hello" --wait

# Wait with timeout
sazabi messages send "Hello" --wait --timeout 120

messages list

List messages in a thread.

sazabi messages list <thread-id>

messages search

Search messages in the current project.

sazabi messages search <query>

runs

Inspect deferred agent runs.

runs get

Get a deferred run by run ID. Use this to poll for completion when a message send returns before the response is ready.

sazabi runs get <run-id>

Examples:

# Check current status
sazabi runs get run_abc123

# Wait for completion
sazabi runs get run_abc123 --wait

# Wait with timeout
sazabi runs get run_abc123 --wait --timeout 60

data-sources

Manage data source connections and streams.

data-sources types

List supported data source types.

sazabi data-sources types

data-sources connections list

List data source connections.

sazabi data-sources connections list

data-sources connections get

Get details for a specific connection.

sazabi data-sources connections get <connection-id>

data-sources connections create

Create a data source connection.

sazabi data-sources connections create --type fly_io --metadata '{"apiToken":"..."}'

data-sources streams list

List streams for a connection.

sazabi data-sources streams list --connection-id <id>

data-sources streams get

Get stream details and provisioning status.

sazabi data-sources streams get <stream-id>

data-sources streams create

Create a stream for a connection.

sazabi data-sources streams create --connection-id <id> --display-name "my-app"

data-sources skill

Show the agent setup skill for a data source type.

sazabi data-sources skill --type gcp

settings

Manage global CLI settings stored in ~/.sazabi/settings.json.

settings view

Show current CLI settings and file location.

sazabi settings view

settings set

Set a global configuration value.

sazabi settings set <key> <value>

Available keys:

Example:

sazabi settings set apiBaseUrl https://api.sazabi.dev

settings unset

Clear a global configuration value.

sazabi settings unset <key>

completions

Generate shell completion scripts for tab completion.

completions zsh

Output zsh completion script.

# Add to ~/.zshrc
eval "$(sazabi completions zsh)"

completions bash

Output bash completion script.

# Add to ~/.bashrc
eval "$(sazabi completions bash)"

Output formatting

All commands support --json for machine-readable output.

Human-readable output

By default, the CLI formats output for terminal readability with tables, colors, and progress indicators:

sazabi projects list

Projects
ID                                    Name            Region   Active
11111111-1111-4111-8111-111111111111  production-api  us-east  yes
22222222-2222-4222-8222-222222222222  staging-api     us-east

JSON output

Use --json for scripting and automation. JSON output includes all fields and is stable across CLI versions:

sazabi projects list --json

{
  "projects": [
    {
      "id": "11111111-1111-4111-8111-111111111111",
      "name": "production-api",
      "region": "us-east"
    }
  ]
}

Error output

Errors in JSON mode include an error field:

{
  "error": "Organization not found"
}

Environment variables

Configure the CLI with environment variables:

Environment variables take precedence over settings file values but are overridden by command-line flags.

Exit codes

Next steps