Manage CLI-built-in feature flags for build-time and install-time capability gates.

nself feature <subcommand> [flags]
nself feature list [--json]
nself feature enable <flag>
nself feature disable <flag>
nself feature status <flag> [--json]

nself feature exposes the binary-local feature flag registry compiled into the nSelf CLI. It is distinct from nself flag, which manages runtime feature flags via the feature-flags plugin on port 3305. The feature subcommand covers build-time and install-time capability gates for v1.1.0+ release features such as ɳSentry, ɳFamily COPPA strict mode, and multi-tenant strict mode.

The registry is defined in internal/featureflags/registry.yaml and compiled into the binary. Per-project overrides persist to .nself/features.json in the current working directory, which nSelf treats as the project root (matching nself build and nself start behavior).

list prints every registered flag with its effective enabled state (override or registry default), the source of the effective value, the flag type, the surface it applies to, and the version that introduced it. Pass --json for machine-readable output.

enable <flag> and disable <flag> record an override in .nself/features.json. They require exactly one positional argument: the flag key. The change is immediate and persists across CLI invocations for that project directory.

status <flag> shows the full registry entry and effective state for one flag. Pass --json to get the structured representation. It exits with an error if the flag key is not registered.

No flags. Requires exactly one positional argument: the flag key.

No flags. Requires exactly one positional argument: the flag key.

# List all registered flags in table format
nself feature list

# List all flags as JSON
nself feature list --json

# Enable a specific flag for this project
nself feature enable nsentry-enabled

# Disable a flag
nself feature disable clawde-telemetry-opt-in

# Check the effective state of one flag
nself feature status nfamily-coppa-strict

# Check a flag's state as JSON
nself feature status nsentry-enabled --json

# Enable ɳFamily COPPA strict mode
nself feature enable nfamily-coppa-strict

• cmd-flag.md — runtime feature-flag management via the feature-flags plugin (port 3305)
• cmd-build.md — build pipeline that reads feature gates at build time
• cmd-plugin.md — install plugins that gate features behind a license
• cmd-doctor.md — verify configuration and detect misconfigured flags

← Commands | Home →