cmd license

nself license

Manage your ɳSelf membership license key.

Synopsis

nself license <subcommand> [flags]

Description

nself license manages the membership license key used to install licensed plugins. The key is stored locally at ~/.nself/license/key with permissions 0600 (readable only by the current user).

Set your key once with nself license set and all subsequent nself plugin install commands for licensed plugins will use it automatically. The key is validated server-side against ping.nself.org, the CLI does not decode or verify the key locally.

Key format: One of four accepted prefixes followed by 32 or more characters:

• nself_pro_*, Pro tier
• nself_max_*, Pro tier
• nself_ent_*, Enterprise tier
• nself_owner_*, Owner tier

Keys are validated with a POST request to https://ping.nself.org/license/validate.

AI Budget Auto-Seed (S69-T04)

When the ɳClaw plugin is running and NSELF_LICENSE_TIER is configured, the claw service automatically seeds a per-user AI spending budget on startup based on your license tier:

Tier	Monthly AI budget cap
Free	$1.00
Basic	$5.00
Pro	$10.00
Elite	$25.00
Business	$50.00
Business+	$100.00
Enterprise	Unlimited

The budget is seeded with source='tier_default'. If you have manually set a budget via nself ai budget set --cap <amount>, the manual override is preserved and the tier default is NOT applied. Set NSELF_LICENSE_TIER in your .env.dev or .env.prod to enable this behavior.

---

nself license tail

Stream live license validation events from ping.nself.org in real time.

Flags

Flag	Default	Description
--filter <field=value>	—	Filter events (repeatable)
--ping-url <url>	$NSELF_PING_URL or https://ping.nself.org	ping_api base URL

Filters

Filter	Example	Description
result=<value>	result=denied	Show only allow, deny, or rate_limit events
key=<prefix>	key=nself_pro_abc	Show events for a specific key (first 12 chars matched)
plugin=<name>	plugin=ai	Show events for a specific plugin

Color coding

Color	Meaning
Green	allow
Red	deny
Yellow	rate_limit

Colors are only shown when output is a terminal. Piped output is plain text.

Behavior

• Starts streaming within 2s of invocation
• Reconnects automatically on connection loss (exponential backoff, max 30s)
• Ctrl-C exits cleanly with no goroutine leak
• License key values are never shown in full, only the first 12 characters (key prefix) are displayed

Examples

# Stream all validation events
nself license tail

# Show only denied validations
nself license tail --filter result=denied

# Show events for a specific key prefix
nself license tail --filter key=nself_pro_abc123

# Combine filters
nself license tail --filter result=denied --filter plugin=ai

Flags

Name	Shorthand	Type	Default	Env	Escalates to	JSON override	Description
--help	-h	bool	false				Show help

Subcommands

Name	Description
account	Manage your ɳSelf account, sessions, licenses, team, and devices
add	Add one or more license keys
clear	Remove all saved license keys
export	Export signed license cache for air-gap transfer
health	Validate format, ping server, and report cache integrity
import	Import a previously exported license cache file
list	Show all configured licenses (alias for status)
login	Log in to your ɳSelf account
logout	Log out of your ɳSelf account
migrate	Migrate legacy license key to a ɳSelf account
refresh	Force-refresh license validation against ping.nself.org
remove	Remove a license key by value or product name
restore	Reactivate dormant plugins with a new license key
revalidate	Force a fresh validation against ping.nself.org and update the cache
revoke	Mark local license as revoked and wipe the stored key
set	Replace all keys with a single key
show	Display license tier, bundles, plugins, and cache expiry
simulate-offline	Simulate being offline for N days (testing only)
status	Show all configured licenses and plugin coverage
tail	Stream live license validation events from ping_api
upgrade	Open pricing page in browser
validate	Validate key against ping.nself.org

Contract

• Side effect: read
• Output: document
• JSON: envelope (data schema)
• Exit codes: none declared

Examples

# Save your license key
nself license set nself_pro_xxxxx...

# Check what key is saved and its tier
nself license show

# Validate the key is still active
nself license validate

# Remove the saved key
nself license clear

# Open the pricing page to upgrade
nself license upgrade

Sample show output:

License key: nself_pro_****************************xxxx
Tier:        Pro
Status:      ✓ active
Stored at:   ~/.nself/license/key

See Also

• Commands — full command index
• Core-Services — what a stack is made of

← Commands | Home →