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
- Gemini, xAI, Mistral and DeepSeek are provider presets
(
gemini,xai,mistral,deepseek), each an OpenAI-compatible endpoint with its own API key. With no settings file, a headless run still prefers an Anthropic, OpenAI, OpenRouter, Groq or Hugging Face key when one of those is set. - MCP servers can hide tools.
include_toolsadvertises only the named tools. Omit it to advertise every tool.exclude_toolsdrops names even when they are included. A filtered-out tool is not offered to the model. /fork [name]copies the current conversation into a new session and continues there. The previous session stays saved./resumeopens it.