nullray¶
Terminal coding agent written in Odin. One static binary, a custom TUI, a Landlock/seccomp sandbox on Linux, and a native tool loop that talks to local models or any OpenAI-compatible API.
If another AI CLI is already configured on the machine, the first run adopts its keys and defaults so there is usually nothing to type. If not, a setup overlay walks through provider and key entry.
What it does¶
- Runs an agent loop in the terminal with file tools, shell, VCS operations, subagents, MCP servers, skills, and session tabs.
- Sandboxes tool execution with Landlock and seccomp on Linux, and keeps API keys out of tool output through privacy scrubbing.
- Works offline against Ollama, LM Studio, and llama.cpp, or against a dozen hosted providers.
- Reviews local Git and Fossil diffs without a forge, and hunts bugs with a dedicated review profile.
- Ships headless too:
--printfor pipelines,--askfor one-shot questions,--reviewfor CI gates.
These docs¶
| Page | Covers |
|---|---|
| Install | Packages, build from source, completions |
| Quick start | First run, setup wizard, first prompt |
| Providers | Provider table, keys, adoption, models |
| Configuration | Config files and every env var |
| Modes and permissions | ask/plan/review/edit, gate, perms, verify |
| TUI | Interface tour, tabs, binds, themes |
| Slash commands | Every / command |
| CLI reference | Every flag, print mode, review bot |
| Sessions | Transcripts, search, usage, compaction |
| Sandbox | Landlock, seccomp, ops profiles, elevate |
| Security | Secret handling, audit, trust decisions |
| Skills and MCP | Skill roots, MCP autoload and trust |
| Subagents | task tool, roles, leases, worktrees |
| Memory and RAG | Project memory, recall, embeddings |
| Troubleshooting | Doctor output, crashes, common fixes |
Source and issues live on GitHub. License is QSL-1.0-0BSD: source-available, converts to 0BSD two years after each release.