Config
A NetBox CLI for humans and AI agents. Single static binary, schema-driven typed flags, versioned JSON output envelope, agent skill files.
npx -y skills add Hebbian-Robotics/nbx --skill configAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
2 things to look at
- no licenseNo license file was found in the repository. Code published without one is not open source by default, so using it at work is a question for whoever answers licensing questions where you are.
- 2 stars2 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Manage nbx NetBox URL, token, and named contexts in ~/.config/nbx/config.toml.
SKILL.md
1.8 KB, 434 tokens by cl100k_base, as published. Nobody here has run it
nbx config
Purpose
Manage ~/.config/nbx/config.toml — nbx's persistent connection store. Supports multiple named contexts (e.g. prod, staging) and a default-context selector.
When to use which action
init --url <url> --token <token> --context <name>— write the initial context. Use this once when bringing up a fresh install.set-url <url> [--context <name>]— update the URL on a context (defaults to the active context).set-token <token> [--context <name>]— update the API token on a context.use-context <name>— switch the default context.current-context— print the currently selected context name.get-contexts— list all configured contexts.show— print the resolved config with tokens redacted; pass--show-tokento include them.
Key behaviors
- File permissions.
~/.config/nbx/config.tomlis written with mode0600. nbx refuses to read a config file that is world- or group-readable. - Selection precedence at runtime.
--context <name>>NBX_CONTEXTenv var >default_contextin the config file. Resource commands inherit this precedence;configitself uses--contextto scope edits. - Tokens are never echoed by default.
showredacts; agents that need the raw token should use--show-tokendeliberately.
Discovering flags and output
Run nbx config --help and nbx config <action> --help for the flag list and behavior of each subaction.
Errors
- exit 1
general— filesystem failure (e.g. cannot create~/.config/nbx/). - exit 2
not_found— context name does not exist. - exit 4
validation_error— malformed URL, missing required field, or refusing to read a config with permissive permissions.
What ships with it
Read from the repository
Just SKILL.md. No reference files, no scripts.