Skip to content

nb config

Workspace-scoped credential management. For when and why to use this versus a host env var, see Credentials.

nb config set <bundle> <key>=<value> -w <wsId>
nb config get <bundle> -w <wsId>
nb config clear <bundle> <key> -w <wsId>

The -w/--workspace flag is required on every action.

Set a value:

Terminal window
nb config set @nimblebraininc/granola api_key=grn_abc123 -w ws_acme

Read current values (masked — first two characters, then ****):

Terminal window
nb config get @nimblebraininc/granola -w ws_acme
api_key: gr****

Remove a single key. If it was the last key, the file is deleted:

Terminal window
nb config clear @nimblebraininc/granola api_key -w ws_acme

Values are written to {workDir}/workspaces/{wsId}/credentials/{bundle-slug}.json with mode 0o600. See Credentials → Store it per-workspace for the slug rule and the surrounding directory layout.

  • Credentials — when to use this vs. host env vars.
  • nb bundle — install and remove bundles.
  • nb reload — pick up new values on a running server.