Commands reference

Every bizos command group — description, usage, flags, examples, JSON output, and credit markers.

The bizos CLI is organized into command groups. Every command supports --json for machine-readable output. Only bizos tasks run and bizos creative generate spend credits (⚠️ 1 credit each) and require --yes. Everything else is free.

Global flags

These apply to every command:

Flag	Description
`--json`	Emit machine-readable JSON instead of formatted text.
`--api-url <url>`	Override the API base URL for this invocation.
`--no-color`	Disable colored output.
`--verbose`	Verbose request logging (the Authorization header is redacted).
`--help`	Show help for any command or group.
`-y, --yes`	Confirm a credit-spending action non-interactively (on `tasks run` and `creative generate`).

Auth

Free. Manage your local session.

Prompts for a bzk_live_… key and stores it at ~/.config/bizos/config.json (chmod 0600).

bizos login

`bizos logout`

Clears the stored key.

bizos logout

`bizos whoami`

Resolves the org, plan, and credit balance from your key. Cost: free.

bizos whoami --json

{
  "org": { "id": "org_abc123", "name": "Acme Inc" },
  "plan": "pro",
  "credits": 42
}

API keys are created in the dashboard, not the CLI — see Authentication.

Tasks

Queue and run agent tasks.

`bizos tasks list`

Lists tasks plus today's usage. Cost: free.

bizos tasks list --json

{
  "items": [
    { "id": "tsk_123", "text": "Draft a cold email", "status": "idle" }
  ],
  "usedToday": 3,
  "limit": 20,
  "remaining": 17
}

`bizos tasks create`

Creates a task from text. Cost: free.

bizos tasks create "Research 10 prospects in solar B2B"

{ "task": { "id": "tsk_456", "text": "Research 10 prospects in solar B2B", "status": "idle" } }

`bizos tasks run` ⚠️ 1 credit

Runs a task by id. Requires --yes. Cost: 1 credit. On failure the credit is refunded automatically. Returns 402 if you are out of credits.

Flag	Description
`<id>`	Task id (required, positional).
`--yes`	Required to authorize the spend.

bizos tasks run tsk_456 --yes --json

{ "ok": true, "status": "running", "runId": "run_789" }

Docs

Read and create org documents.

`bizos docs list`

Lists documents. Cost: free.

Flag	Description
`--folder <id>`	Filter to a folder.
`--all`	Include all folders.

bizos docs list --all --json

{ "items": [ { "id": "doc_1", "title": "ICP brief", "kind": "note" } ] }

`bizos docs get`

Fetches one document. Cost: free.

bizos docs get doc_1 --json

{ "item": { "id": "doc_1", "title": "ICP brief", "content_md": "# ICP\n..." } }

`bizos docs create`

Creates a document. Cost: free.

Flag	Description
`--title <t>`	Title (required).
`--file <path>`	Read markdown body from a file (optional).
`--content <md>`	Inline markdown body (optional).
`--kind <k>`	Document kind (optional).
`--folder <id>`	Target folder (optional).
`--summary <text>`	Short summary (optional).

bizos docs create --title "Q3 plan" --content "# Q3\n- ship CLI" --json

{ "item": { "id": "doc_2", "title": "Q3 plan" } }

Leads

Read captured prospects.

`bizos leads list`

Lists prospects from connected lead sources. Cost: free.

bizos leads list --json

{
  "connected": true,
  "prospects": [
    { "id": "lead_1", "name": "Jane Doe", "email": "jane@acme.com", "phone": "+1...", "createdTime": "2026-06-01T10:00:00Z", "campaign": "Solar B2B" }
  ]
}

Creative

Generate ad creatives.

`bizos creative generate` ⚠️ 1 credit

Generates an ad image and hosts it. The prompt is a positional argument, not a flag. Requires --yes. Cost: 1 credit. On failure the credit is refunded. Returns 402 if out of credits.

Flag	Description
`<prompt>`	Creative prompt (required, positional).
`--size <s>`	Output size, e.g. `1024x1024` (optional).
`--quality <q>`	Render quality (optional).
`--angle <a>`	Marketing angle (optional).
`--format <f>`	Output format (optional).
`--label <l>`	Label for the artifact (optional).
`-y, --yes`	Required to authorize the spend.

bizos creative generate "Minimalist solar panel ad, white bg" --size 1024x1024 --yes --json

{ "url": "https://cdn.bizos.lol/creatives/art_1.png", "artifactId": "art_1" }

Landing

Manage landing pages.

`bizos landing list`

Lists landing pages. Cost: free.

bizos landing list --json

{ "items": [ { "id": "lp_1", "title": "Solar offer", "slug": "solar-offer", "status": "draft" } ] }

`bizos landing create`

Creates a landing page draft, renders it by default, and can publish it. Cost: free. All fields are optional.

Flag	Description
`--business-name <s>`	Business name.
`--subdomain <s>`	Preferred subdomain.
`--page-type <s>`	Page type.
`--spec <json>`	Page spec as a JSON string.
`--strategy <json>`	Strategy as a JSON string.
`--no-render`	Create the draft without rendering.
`--publish`	Publish after rendering.

bizos landing create --business-name "Acme Solar" --subdomain acme-solar --publish --json

{ "site": { "id": "lp_2" }, "version": { "id": "ver_1" }, "published": true }

Flag	Description
`--range <range>`	Date range (e.g. `7d`, `30d`; default `7d`).

Wallet

`bizos wallet`

Reads your prepaid wallet balance and funding/auto-recharge state. Cost: free. Payments stay on the web.

bizos wallet --json

{ "balance": 18.50, "funding": "card", "autoRecharge": { "enabled": true, "threshold": 5 } }

Billing

`bizos billing`

Reads your plan, credit balance, and available tiers/packs. Cost: free.

bizos billing --json

{ "plan": "pro", "credits": 42, "tiers": [ ... ], "packs": [ ... ] }

See Billing & credits for how spending and top-ups work.

Notifications

`bizos notifications`

Lists notifications and the unread count (this is the default action of the group — there is no list subcommand). Cost: free.

bizos notifications --json

{ "items": [ { "id": "ntf_1", "title": "Task finished", "read": false } ], "unread": 1 }

`bizos notifications read`

Marks a notification read by id. Cost: free.

bizos notifications read ntf_1 --json

{ "ok": true }

Commands that spend credits

Command	Cost	Requires
`bizos tasks run <id>`	⚠️ 1 credit	`--yes`
`bizos creative generate`	⚠️ 1 credit	`--yes`

Everything else in this reference is free.