Manage your Stack0 resources from the terminal — send email, upload to the CDN, capture screenshots, extract structured data, run AI workflows, and more.
stack0 mail send --from [email protected] --to [email protected] \
--subject "Hello" --text "Sent from the Stack0 CLI"Requires Node.js 18+.
npm install -g @stack0/cli
# or
bun add -g @stack0/cliOr run without installing:
npx @stack0/cli --help
# or
bunx @stack0/cli --helpThe CLI is installed as the stack0 binary.
Sign in with the interactive device flow (opens your browser):
stack0 auth loginPrefer an API key directly? Pass it inline, set it as an environment variable, or save it:
stack0 auth login --api-key sk_live_... # save the key
stack0 config set apiKey sk_live_... # same thing, persisted to config
export STACK0_API_KEY=sk_live_... # per-shellInspect or clear your session:
stack0 auth whoami # show the active identity (key is masked)
stack0 auth status # auth + config summary, including config file path
stack0 auth logout # clear all stored credentialsCredentials are stored locally via conf. Run stack0 auth status to see the exact config file path.
The CLI resolves each value from, in order: command-line flag → environment variable → saved config.
| Config key | Flag | Environment variable | Description |
|---|---|---|---|
apiKey |
--api-key <key> |
STACK0_API_KEY |
API key used for authentication |
defaultProject |
-p, --project <id> |
STACK0_PROJECT |
Default project |
defaultEnvironment |
-e, --env <env> |
STACK0_ENV |
sandbox or production |
baseUrl |
--base-url <url> |
STACK0_BASE_URL |
Custom API base URL |
Manage saved defaults:
stack0 config set defaultProject my-project
stack0 config set defaultEnvironment production
stack0 config get # show all values
stack0 config get defaultProject # show one value
stack0 config reset # clear everything (asks to confirm)These flags work on every command:
| Option | Description |
|---|---|
--api-key <key> |
API key for authentication |
-p, --project <id> |
Project ID |
-e, --env <env> |
Environment (sandbox or production) |
--json |
Output raw JSON instead of formatted tables |
--verbose |
Verbose output |
--no-color |
Disable colored output |
--base-url <url> |
Override the API base URL |
Pass --json to any command for machine-readable output, ideal for scripting:
stack0 mail list --json | jq '.[].id'Run stack0 <command> --help (or stack0 <command> <subcommand> --help) for full, up-to-date options on any command.
login · logout · whoami · status
set · get · reset
send · list · get · resend · cancel · analytics · domains · templates · contacts · audiences · campaigns · sequences · events
# Send a plain-text email
stack0 mail send --from [email protected] --to [email protected] \
--subject "Welcome" --text "Thanks for signing up!"
# Send HTML from a file (prefix the path with @)
stack0 mail send --from [email protected] --to [email protected] \
--subject "Welcome" --html @./welcome.html
# Send a template with variables
stack0 mail send --from [email protected] --to [email protected] \
--subject "Your receipt" --template-id tmpl_123 \
--vars '{"name":"Alex","amount":"$42.00"}'upload · list · get · update · delete · delete-many · move · transform · usage · folders · video · private · bundles · imports
stack0 cdn upload ./logo.png --folder brand --project my-project
stack0 cdn list --project my-project
stack0 cdn transform asset_123 --width 400 --format webpcapture · list · get · delete · batch · schedules
# Capture and wait for the result
stack0 screenshots capture https://example.com --full-page --format webp
# Fire-and-forget: return a job ID immediately
stack0 screenshots capture https://example.com --no-waitextract · list · get · delete · batch · usage · schedules
# Markdown extraction
stack0 extraction extract https://example.com/article --mode markdown
# Schema-driven structured extraction (inline JSON or @file.json)
stack0 extraction extract https://example.com/product \
--mode schema --schema @./product-schema.jsoncreate · list · get · update · delete · run · runs
stack0 workflows list
stack0 workflows run wf_123
stack0 workflows runs list --project my-projectconnectors · connections · stats · logs · crm · storage · communication · productivity
trends · opportunities · content · scripts · analytics · calendar · settings · usage
The CLI is a thin wrapper over the @stack0/sdk. If you need Stack0 inside your own code, use the SDK directly:
import Stack0 from "@stack0/sdk";
const stack0 = new Stack0({ apiKey: process.env.STACK0_API_KEY });
await stack0.mail.send({ from, to, subject, text });