nb status
nb status displays a summary of your NimbleBrain workspace: configured bundles, loaded skills, and — if a server is running — live health information for each bundle process.
nb status [flags]| Flag | Description |
|---|---|
--config <path> | Config file path |
--json | Output as JSON |
Checking status
Section titled “Checking status”nb statusBundles: 3 configured @nimblebraininc/bash @nimblebraininc/granola @nimblebraininc/postgresSkills: 4 loadedStatus with a running server
Section titled “Status with a running server”When a NimbleBrain server is running on the default port (27247), nb status also queries the /v1/bundles/health endpoint and shows live bundle health:
nb statusBundles: 3 configured @nimblebraininc/bash @nimblebraininc/granola @nimblebraininc/postgresSkills: 4 loaded
Bundle health: @nimblebraininc/bash: running (uptime: 3842s, restarts: 0) @nimblebraininc/granola: running (uptime: 3842s, restarts: 0) @nimblebraininc/postgres: crashed (uptime: n/a, restarts: 3)Each bundle shows its state (running, crashed, dead, starting, stopped), uptime in seconds, and restart count.
JSON output
Section titled “JSON output”Get machine-readable output with --json:
nb status --json{"bundles":[{"name":"@nimblebraininc/bash"},{"name":"@nimblebraininc/granola"},{"name":"@nimblebraininc/postgres"}],"skills":[{"name":"bootstrap","type":"context","priority":100,"source":"src/skills/core/bootstrap.md","description":"Teaches the agent about meta-tools and mpak"}],"health":[{"name":"@nimblebraininc/bash","state":"running","uptime":3842000,"restartCount":0},{"name":"@nimblebraininc/granola","state":"running","uptime":3842000,"restartCount":0},{"name":"@nimblebraininc/postgres","state":"crashed","uptime":null,"restartCount":3}]}The JSON output includes three keys:
bundles— the bundle entries from your configskills— all loaded skills with metadatahealth— live state from the running server (empty array if no server is running)