Skip to main content

nself license

nself license — ɳSelf documentation.

Manage your ɳSelf Pro membership license key.

Synopsis

nself license <subcommand>

Description

nself license manages the Pro membership license key used to install paid 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 Pro 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: nself_pro_<32+ chars>. Every bundle and ɳSelf+ purchase uses this same prefix; the granted tier is resolved server-side from the license record, not from the key format.

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

Subcommands

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

Examples

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

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

# Check active subscriptions and renewal dates
nself license status

# Validate the key is still active
nself license validate

# Remove a specific saved key
nself license remove nself_pro_xxxxx...

# Remove all saved keys
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