Manage your ɳSelf+ subscription and plugin bundle billing. Shows usage, previews upcoming invoices, and triggers Stripe webhook retries — all via ping.nself.org without leaving the terminal.
# Check current subscription and billing status
nself billing status
# Show this month's plugin usage breakdown
nself billing usage
# Preview the next invoice before it closes
nself billing invoice-previewnself billing <SUBCOMMAND> [FLAGS]nself billing is the terminal interface to the nSelf billing layer, which is backed by Stripe and orchestrated through ping.nself.org. Every subcommand authenticates using the account session stored by nself account login; no separate API key is required.
Billing information is scoped to the nSelf account that owns the active license key. If you manage multiple projects or teams, switch accounts with nself account status and re-run the billing command in the correct context.
The Stripe integration uses signed webhooks. If a webhook delivery fails (network blip, server restart), nself billing retry-event re-queues the specific event for re-delivery without waiting for Stripe's automatic retry schedule.
Show the active subscription plan, renewal date, payment method on file, and the list of bundles currently entitled on this account.
nself billing status
# Example output:
# Plan: ɳSelf+ ($3.99/mo)
# Renews: 2026-06-07
# Status: active
# Payment: Visa ·· 4242 exp 12/27
# Bundles: ɳClaw, ɳChat, ɳTV, ClawDE, ɳFamily, ɳSentry| Flag | Description |
|---|---|
--json | Output as JSON (CI-friendly) |
Display plugin usage metrics for the current billing period. Shows API call counts, data transfer, compute time, and any metered charges that will appear on the next invoice.
nself billing usage
# Scope to a specific bundle
nself billing usage --bundle nclaw
# Show previous billing period
nself billing usage --period prev| Flag | Default | Description |
|---|---|---|
--bundle NAME | all | Filter by bundle name: nclaw, nchat, ntv, clawde, nfamily, nsentry |
--period current|prev | current | Billing period to inspect |
--json | false | Output as JSON |
Show a line-item preview of the invoice that will be issued at the end of the current billing period. Includes any metered usage charges that have accrued so far this month.
nself billing invoice-preview
# Example output:
# Period: 2026-05-07 – 2026-06-07
# ɳSelf+ subscription $3.99
# ɳTV metered encoding $0.12
# ──────────────────────────────
# Total due 2026-06-07 $4.11| Flag | Description |
|---|---|
--json | Output as JSON |
Generate a full billing report for a completed billing period. Useful for expense reporting and accounting. The report includes subscription charges, metered usage, taxes, and any credits applied.
# Report for the most recently closed period
nself billing report
# Report for a specific period (YYYY-MM)
nself billing report --period 2026-04
# Export to CSV
nself billing report --period 2026-04 --format csv > billing-april.csv| Flag | Default | Description |
|---|---|---|
--period YYYY-MM | last closed | Month to report on |
--format text|json|csv | text | Output format |
Re-queue a Stripe webhook event for immediate re-delivery. Use this when a webhook delivery failed and you do not want to wait for Stripe's 72-hour automatic retry schedule. Requires the Stripe event ID, which appears in the Stripe dashboard or in ping_api logs.
# Re-deliver a specific webhook event
nself billing retry-event evt_1ABC2DEF3GHI
# List recent failed events, then retry
nself billing retry-event --list-failed
nself billing retry-event evt_<ID>| Flag | Description |
|---|---|
--list-failed | Show recent failed webhook events with their IDs |
--dry-run | Verify the event ID resolves without re-sending |
| Flag | Description |
|---|---|
--account EMAIL | Target a specific nSelf account (useful with multiple logins) |
--timeout DURATION | HTTP timeout for ping_api calls (default: 30s) |
When you run nself license set nself_pro_..., the CLI callsping.nself.org/license/activate which creates or updates a Stripe subscription for your account. The subscription tier is determined server-side from the license key prefix.
Bundle entitlements are checked on every nself plugin install. The CLI callsping.nself.org/license/validate with the plugin name. If the active subscription does not cover the requested plugin, the install is refused with a clear upgrade prompt.
The billing API uses a 7-day FAIL-OPEN cache for license validation. Ifping.nself.org is temporarily unreachable, the CLI uses the last successful validation response and warns you that you are operating in cached mode.
| Plan | Monthly | Annual | Includes |
|---|---|---|---|
| Any single bundle | $0.99 | $9.99 | All plugins in that bundle |
| ɳSelf+ | $3.99 | $39.99 | All 6 bundles + all apps + support |