nora billing

Billing surfaces workspace-level financial information from the CLI. Every workspace on a paid plan has these commands; free workspaces show the free-tier state.

Commands

Command	Description
`billing state`	Current subscription snapshot.
`billing usage`	Per-meter usage for current period.
`billing history`	Historical monthly usage.
`billing invoices`	All issued invoices.
`billing portal`	Print/open provider-hosted customer portal URL.
`billing set-overage-cap`	Cap or clear monthly overage.
`billing open`	Print/open Nora billing settings URL.
`billing set-tax`	Set business tax fields.

`billing state`

nora billing state

Prints:

Plan (Free / Team / Enterprise).
Subscription status (active / past_due / canceled).
Current period (start & end).
Overage cap (if set).
Overage used this period.

Add --json for machine output.

`billing usage`

nora billing usage

Current billing period usage broken down by meter:

Model tokens (per provider tier).
Storage (documents, chunks, vectors).
Trace volume.
Any per-plan meters.

Compare against your plan’s included quotas.

`billing history`

nora billing history                                    # last 6 months (default)
nora billing history --from 2026-01-01 --to 2026-06-30  # custom range

Monthly usage rollup. Useful for cost analysis and forecasting.

`billing invoices`

nora billing invoices

Lists all invoices ever issued for this workspace:

Invoice number.
Period covered.
Amount.
Status (paid / open / uncollectible).
PDF link.

Add --json for a script-friendly list.

`billing portal`

nora billing portal                # prints the URL
nora billing portal --launch       # opens in default browser

The customer portal (hosted by our payment provider, Polar) lets you:

Update payment method.
View past invoices (with PDFs).
Update billing email.
Cancel or change plan.

You’ll authenticate on the portal side with the same email as your Nora account.

`billing set-overage-cap`

# Cap overage at $50/month
nora billing set-overage-cap --cents 5000

# Clear cap (use plan default)
nora billing set-overage-cap --clear

Overage cap limits how much you’ll be billed above your plan’s included quotas. When the cap is hit, further usage is blocked — pending overage-approved requests fail with 402.

--cents <n> — cap in cents (US$).
--clear — use the plan default (varies by plan).

Only Owners can change this.

`billing open`

nora billing open                                       # print URL to billing settings
nora billing open --section usage                       # deep-link to usage
nora billing open --section invoices --launch           # open invoices in browser

Flags:

--section plans|usage|invoices — which page to link to.
--launch — open in default browser instead of printing.

`billing set-tax`

nora billing set-tax \
  --business-number "123-45-67890" \
  --tax-email billing@yourcompany.com

For Korean workspaces (and similar tax regimes), sets:

--business-number — the tax registration number (사업자등록번호). Pass "" to clear.
--tax-email — email for tax-invoice delivery.

These fields flow onto your invoices.

Recipes

Set an overage cap in a bootstrap script

# $200 monthly overage limit
nora billing set-overage-cap --cents 20000

Monitor spend

# Alert if this month's usage crosses a threshold
usage_cents=$(nora billing usage --json | jq '.total_cents')
[ "$usage_cents" -gt "50000" ] && echo "Warning: >$500 spend this month"

Download all invoice PDFs

mkdir -p invoices
for inv in $(nora billing invoices --json | jq -c '.[]'); do
  url=$(echo "$inv" | jq -r '.pdf_url')
  num=$(echo "$inv" | jq -r '.number')
  curl -sL "$url" -o "invoices/${num}.pdf"
done

Compare usage across workspaces

for ws in acme-dev acme-staging acme-prod; do
  echo "$ws:"
  nora --workspace "$ws" billing usage --json | jq '.total_cents' | \
    awk '{printf "  $%.2f\n", $1/100}'
done

What billing does NOT cover

Provider costs (OpenAI, Anthropic, Google API charges) — billed by the providers directly if you’re on BYOK (bring your own key). See nora providers.
Storage attached via BYO buckets — you pay your S3/R2 provider directly.

Nora billing covers the platform layer: workflow execution, trace storage, retrieval infrastructure, memory, and managed services.

Payments docs — plan details and included quotas.
nora providers — provider API key management (billed by provider).
Audit trail — billing-related changes are logged.

Setup

Flows

Blocks

Data & knowledge

Reliability

Workspace

Reference

nora billing

Commands

`billing state`

`billing usage`

`billing history`

`billing invoices`

`billing portal`

`billing set-overage-cap`

`billing open`

`billing set-tax`

Recipes

Set an overage cap in a bootstrap script

Monitor spend

Download all invoice PDFs

Compare usage across workspaces

What billing does NOT cover

​Commands

​billing state

​billing usage

​billing history

​billing invoices

​billing portal

​billing set-overage-cap

​billing open

​billing set-tax

​Recipes

​Set an overage cap in a bootstrap script

​Monitor spend

​Download all invoice PDFs

​Compare usage across workspaces

​What billing does NOT cover

​Related

Commands

`billing state`

`billing usage`

`billing history`

`billing invoices`

`billing portal`

`billing set-overage-cap`

`billing open`

`billing set-tax`

Recipes

Set an overage cap in a bootstrap script

Monitor spend

Download all invoice PDFs

Compare usage across workspaces

What billing does NOT cover

Related