
# nexo
### The coding agent that doesn't run out of context.
**No compaction. No summaries. The whole history stays on disk.**
A real session, unedited: deepseek-flash runs the tests of a small invoice module, fixes the two bugs and answers with a table. 3 steps, 93% cache hit, $0.0020 for the whole session ([ui] detail = "full").
[**Install**](#install) · [**Proof**](#proof) · [**How it works**](#how-it-works) · [**Providers**](#providers) · [**Full guide**](nexo/README.md)
[](https://github.com/Locotir/nexo/actions/workflows/ci.yml)
[](https://www.rust-lang.org)
[](LICENSE)
[](#install)
[](#providers)
[](https://www.paypal.me/locotir)
```sh
curl -fsSL https://raw.githubusercontent.com/Locotir/nexo/main/install.sh | sh # Linux and macOS; Windows and source below
```
nexo is a terminal coding agent written in Rust, for any model provider. Its context curator keeps long sessions
small without summaries: the whole history stays on disk, and the model is sent only what the next step needs.
It runs as a full-screen TUI, headless for scripts and CI, or inside editors over the Agent Client Protocol (ACP).
| | An agent that compacts | nexo |
| --- | --- | --- |
| The window fills up | a summary replaces the work | nothing is summarized, the history stays on disk |
| The exact error line from early in the session | gone with the summary | comes back by itself when a step names it |
| The provider's prompt cache | restarts after each compaction | keeps hitting: the view is rewritten only at an epoch |
## Install
**Linux and macOS** (Apple silicon and Intel; downloads the ready-built file, checked against its SHA-256, to `~/.local/bin`):
```sh
curl -fsSL https://raw.githubusercontent.com/Locotir/nexo/main/install.sh | sh
```
**Windows** (PowerShell, to `%LOCALAPPDATA%\Programs\nexo`):
```powershell
irm https://raw.githubusercontent.com/Locotir/nexo/main/install.ps1 | iex
```
On macOS the file is signed ad hoc and fetched with `curl`, so Gatekeeper stays quiet. If you download it in a browser instead, clear the quarantine mark first:
`xattr -d com.apple.quarantine ./nexo-macos-aarch64 && chmod +x ./nexo-macos-aarch64` (use `nexo-macos-x86_64` on an Intel Mac).
From source on any system: `cargo install --locked --git https://github.com/Locotir/nexo nexo-cli`.
CI runs both installers on Linux x64 and ARM and Windows x64 and ARM; the macOS (arm64 and Intel) installer jobs are new and have not run yet.
nexo checks for a newer release in the background; `nexo update` installs it. Turn the check off with
`[ui] update_check = false` or `NEXO_NO_UPDATE_CHECK=1`.
## First run
```sh
export DEEPSEEK_API_KEY=... # or ANTHROPIC_API_KEY, OPENAI_API_KEY, GEMINI_API_KEY, ...
cd your/project
nexo # full-screen interface
nexo -p "run the tests and fix what fails" # headless: prints the reply
nexo --continue # resume the latest session here
nexo doctor # checks files, provider, model and key with one live call
nexo --provider ollama --model qwen3:8b # no key: a local model
```