# 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](https://buildwithnexus.dev/docs/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_tools` advertises only the named tools. Omit it to advertise every tool. `exclude_tools` drops 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. `/resume` opens it.

[Next: Changelog →](https://buildwithnexus.dev/docs/changelog)

MIT licensed · Made by [Garrett Eaglin](https://garretteaglin.com/)
