Sauri

Terminal-first AI coding agent.

DeepSeek. OpenAI. Any OpenAI-compatible endpoint. Your Terminal, your Rules.

---

Install

npm install -g sauri-cli

Quick start

sauri                          # interactive mode — type /model to configure a provider
sauri -p "explain TCP"         # non-interactive (headless) mode
sauri --model deepseek-v4-pro -p "review this diff"

---

Features

Your provider, your rules	Built-in DeepSeek and OpenAI catalogs, plus any OpenAI-compatible endpoint — Ollama, vLLM, LM Studio. No vendor lock-in.
One-time setup	Pick a provider and paste an API key once with /model. Saved permanently in ~/.sauri/config.json. Local models (Ollama, LM Studio, ...) need no API key — they're auto-detected.
Built-in tools	File operations, shell commands, web fetching, MCP (Model Context Protocol) support, and more.
Time travel	/travel -20m rewinds the session and the file system to a point in the past.
Privacy-first	Telemetry (usage statistics) is off by default.
Terminal-first	Designed for developers who live in the command line.

Providers

Provider	Default base URL	Models
DeepSeek	https://api.deepseek.com/v1	deepseek-v4-pro, deepseek-v4-flash, deepseek-chat, deepseek-reasoner (+ custom)
OpenAI	https://api.openai.com/v1	gpt-5, gpt-5-mini, gpt-5-nano, o3, o3-mini, gpt-4.1, gpt-4.1-mini, gpt-4o, gpt-4o-mini (+ custom)
Custom API	— (you provide)	any model ID — works with Ollama, vLLM, LM Studio, ...
Local Model	auto-detected (localhost 11434 / 1234 / 8000)	models served by your local Ollama / LM Studio / vLLM — no API key
Google	—	standard Google model picker

Type /model inside Sauri for a guided wizard, or set the model directly:

/model set <model-id> [--persist]

Configuration

~/.sauri/config.json (chmod 600) — written by /model:

{
  "provider": "deepseek",
  "baseUrl": "https://api.deepseek.com/v1",
  "apiKey": "sk-...",
  "model": "deepseek-v4-flash"
}

Environment variables work too — explicit env vars take precedence over the saved config, and an explicit --model flag takes precedence over everything.

---

Development

Clone, build, and link the CLI locally:

git clone https://github.com/Rismaonee/sauri.git
cd sauri
npm install
npm run build
npm link --workspace @sauri/cli

Quality checks:

npm run build        # build all packages
npm test             # unit tests
npm run lint         # eslint
npm run typecheck    # typescript

See docs/sauri.md for details, including an alternative direct-symlink install.

License

Apache-2.0 — see LICENSE.