Extensions

Context extensions

Resolve <plugin-root> as two directories above the directory containing this file. Run:

node "<plugin-root>/src/codex/neatcontext-cli.mjs" extensions

Relay the report. Two separate things are being reported, and the difference matters:

• What the context expects — the extension it declares and the capability that provides. This travels with the context and is the same on every machine it reaches.
• What this machine provides for it. That is local, hand-written, and lives in the bindings file the report names. Nothing configures it automatically, and nothing inside a shared context can configure it.

If something is reported as not configured, show the example binding from the report and say where the file goes. Tell the user to keep credentials in the environment and name them under envFrom rather than writing them into the file.

If an extension is reported as unavailable or failed, relay the reason exactly as given — a command that is not there, a server that did not answer — and do not guess at a fix beyond what the report says.

Say plainly that the context still works: its profile and knowledge folder are served whether or not any extension is configured.

To record that this context expects something new:

node "<plugin-root>/src/codex/neatcontext-cli.mjs" extensions add <id> --capability "<what it lets this context do>"

Add --tools a,b to narrow it to specific tools, and --important when the context leans on it. That records what the context wants; it connects nothing on its own. extensions remove <id> drops the declaration and leaves any local binding alone, and extensions test <id> starts one on purpose and names the tools it really offers.