buildwithnexusv0.21.0
Menu

What's new in 0.21

Released 2026-11-15. Upgrade with npm install -g buildwithnexus@latest or cargo install buildwithnexus --locked. Older release notes stay in the changelog.

The shell sandbox is on by default

"sandbox": "auto" confines a shell command when a backend works. "sandbox": "off" or --sandbox off runs it unsandboxed. "require" refuses the command when no backend works. A bad sandbox value in settings warns and leaves the sandbox off, so a typo cannot lock a session. An explicit --sandbox on a command, and a settings file that already sets sandbox, keep the mode you wrote.

Linux uses bubblewrap when it works, including a private /tmp and a read-only .git. When bubblewrap is missing, including in WSL when the kernel allows it, auto and require use Landlock and seccomp. Landlock cannot keep .git read-only inside a writable workspace, and it allows writes under /dev so a command can open /dev/null.

Sandboxed git writes are blocked

A sandboxed shell command cannot write .git, so it cannot plant a hook or a git config that would run later outside the sandbox. git fetch, git pull and git commit from the shell fail, and the tool result says why and names --sandbox off. bwn's own auto-commit of file edits runs outside the sandbox and still succeeds while the sandbox is on.

File edits are committed

In a git repository, file-tool edits are committed. The subject starts with bwn:. Git hooks and fsmonitor are not run. Shell commands are not committed. The commit runs outside the sandbox. "auto_commit": false or --no-auto-commit leaves the edits uncommitted. /commit still asks before it commits.

repo_map is a tool

The model can ask for a map of files and top-level symbols. The map is not inserted into the prompt. "repo_map": false or --no-repo-map hides the tool. Small context windows still get the compact tool list, which does not include it.

A gemini name selects the Gemini preset

A model name that starts with gemini selects the Gemini preset. "route_gemini": "openrouter" or --route-gemini openrouter sends it to OpenRouter as google/<name>. /model openrouter google/gemini-… still selects OpenRouter. A settings file that does not mention route_gemini uses the Gemini preset.

More providers, MCP filters, and /fork

Next: Changelog →