CLI - Sazabi

The Sazabi CLI (sazabi) drives the platform from a terminal and from scripts. Every command below is generated from the CLI’s command registry, so this reference always matches the installed binary.

Get started

Paste this into your coding agent to have it set up Sazabi:

Set up Sazabi for me: run `npx -y @sazabi/cli start` and follow the instructions it prints.

Or run it yourself in a terminal:

npx @sazabi/cli start

No install needed. It prints how to sign in and the first step. After each step, run npx @sazabi/cli onboarding start for the next one, until it says onboarding is complete. If Claude Code, Codex, Cursor, or Gemini is installed, it also prints the one command that hands setup to that agent:

npx @sazabi/cli start --agent claude

Install

Keep the CLI around for everyday use. Install it globally with your package manager; for most environments, use npm:

npm install -g @sazabi/cli

Confirm the install:

sazabi --version

Authenticate

Sign in with the browser device flow. This opens a browser, approves the device, and stores a credential for the active profile:

sazabi auth sign-in

Confirm the identity, organization, and project the CLI resolved:

sazabi auth whoami

Running without a browser

CI, scripts, and headless agents can skip sazabi auth sign-in. Set SAZABI_TOKEN to a secret key, or pass the key with --token on each command, and set SAZABI_PROJECT_ID to the project’s ID. Create the key at Settings > Secret keys or, while signed in, with sazabi secret-keys create "<name>". Commands then run with no sign-in:

export SAZABI_TOKEN="<your secret key>"
export SAZABI_PROJECT_ID="<project-id>"
sazabi log-sources list

A secret key belongs to an organization that already exists, so creating an organization (sazabi organizations create) and subscribing to a plan (sazabi billing plans subscribe) still need a signed-in person. Keep the key in a secrets manager and never commit it.

Organization and project context

Most commands run against the active project. Set the active organization and project once; later commands use them until you change them:

sazabi organizations use    # Choose the active organization
sazabi projects use         # Choose the active project

Every command accepts --json for machine-readable output.

In this section

sazabi agent-dispatches

Hand work to coding agents and follow their attempts.

sazabi artifacts

Manage issue artifacts.

sazabi auth

Manage authentication credentials.

sazabi billing

View and manage billing: usage, plans, credits, and subscribe.

sazabi completions

Shell completion scripts.

sazabi connected-accounts

Manage your personal connected accounts.

sazabi dashboards

Author, render, and manage project dashboards written as MDX.

sazabi env

Manage sandbox environment variables.

sazabi integrations

Connect and inspect integrations.

sazabi issues

Manage issues.

sazabi log-sources

Manage log sources.

sazabi log-streams

Manage log streams.

sazabi logs

Ask about, query, and forward logs.

sazabi mcp

Search and execute connected MCP tools.

sazabi mcp-connectors

Manage MCP connectors.

sazabi members

Manage organization members.

sazabi memory

Read, search, and update durable project memory.

sazabi messages

Send, list, and search messages.

sazabi notifications

Manage notification delivery rules and inspect channels.

sazabi onboarding

Set up your account from the terminal, one step at a time.

sazabi organizations

Manage organizations.

sazabi profiles

Manage named CLI profiles.

sazabi projects

Manage projects.

sazabi public-keys

Manage public keys.

sazabi pull-requests

List pull requests opened by Sazabi.

sazabi recommendations

View setup recommendations for a project.

sazabi repos

Manage the repositories linked for code search.

sazabi runs

Inspect deferred agent runs.

sazabi sandbox-clis

Manage sandbox CLIs.

sazabi secret-keys

Manage secret keys.

sazabi settings

Manage global CLI settings.

sazabi setup-tasks

Track the setup tasks for the active project.

sazabi sign-in

sazabi sign-out

Remove saved credentials.

sazabi sign-up

Create a new Sazabi account via browser.

sazabi signals

View what Sazabi’s detectors reported.

sazabi sso

Set up single sign-on.

sazabi start

Show how to get started with Sazabi.

sazabi support

Get help from Sazabi support.

sazabi tasks

Manage tasks and automatic task creation rules in connected trackers.

sazabi teams

Manage organization teams.

sazabi threads

Manage agent threads.

sazabi tool-permissions

List and delete the tool calls a project’s agents run without asking.

sazabi update

Update the CLI to the published version.

sazabi webhooks

Manage webhook endpoints.