
# openbatrangs
A terminal coding agent for local language models, on any hardware.
[](https://github.com/arpanpathak/openbatrangs/actions/workflows/ci.yml)
[](https://github.com/arpanpathak/openbatrangs/actions/workflows/ci.yml)
[](https://github.com/arpanpathak/openbatrangs/releases)
[](https://crates.io/crates/openbatrangs)
[](LICENSE)
[](https://doc.rust-lang.org/edition-guide/rust-2024/)
[](#install)
[](#install)
[](https://colab.research.google.com/github/arpanpathak/openbatrangs/blob/main/colab/openbatrangs.ipynb)
## Your model, your hardware, no subscription
You don't need a Claude subscription or any other paid coding assistant for
agentic coding. Serve an open model such as Qwen3-Coder, Gemma 4 or Nemotron on
your own GPU, or on a GPU cloud VM rented by the hour, and run openbatrangs on
your laptop against it. Your code stays on machines you control, and you pay
only for the hardware or the VM time.
- **Engines:** TensorRT Edge-LLM, TensorRT-LLM, vLLM, SGLang, llama.cpp, Ollama,
and any server with OpenAI's chat completions API.
- **Hardware:** Linux on x86_64 and ARM64, and macOS on Apple silicon and Intel.
- **Agent loop:** one tool call per step, with no step limit unless you set one. Tools for listing,
reading, searching, writing and editing files, running shell commands, and
searching the web.
- **Modes:** `agent` with every tool, `plan` with read-only tools, and `chat`
with none.
- **Safety:** a `y` or `n` prompt before each file write and shell command in
the terminal UI, and with `--confirm` for one-shot tasks. `--read-only` for
no writes or commands at all. Every command runs in the operating system's
sandbox, which lets it write only inside the project folder: bubblewrap
(`bwrap`) on Linux and `sandbox-exec` on macOS. Where neither works, you
approve each command. Commands that delete or reset files, such as `rm` or
`git reset --hard`, always ask first. Every command also runs with `$HOME`
and tool caches inside the project's `.agent/` folder, without keyboard
input, and under a timeout.
- **Web search:** `web_search` and `web_read` through a
[SearXNG](https://github.com/searxng/searxng) instance.
- **Folded steps:** one line per step with a title, the model and the time
taken. Open a step for its reasoning, its decision and each tool call with
its result, then open those for the full text.
- **Markdown answers:** headings, lists, tables, links and highlighted code.
- **Live server stats:** the model server's GPU utilization, power, temperature
and memory from servers that publish `/v1/system`, such as
[thor-tigress-agent](https://github.com/arpanpathak/thor-thunder-tigress-platform),
or running requests and KV-cache use from vLLM, SGLang and llama.cpp
`/metrics`, with this machine's CPU, memory and tokens per second below them.
- **Terminal UI:** slash commands and a model picker. Click a step to fold it,
or press Tab to reach the transcript, the arrow keys to choose a step, and
Enter to fold it.
- **Reasoning display:** the reasoning of thinking models such as Qwen3 and
Nemotron, dimmed before each step, or hidden with `--no-think`.
## Engines
| | Engine | Option |
|---|---|---|
|