v0.2 · MIT licence
The coding agent you can leave alone.
Every command inside a real OS sandbox, every run capped in cents, every tool call on record.
- Licence
- MIT
- Install
- one file
- A run
- cents
The machine enforces the rules, not your attention span.
What happens between your prompt and the diff you review. The same four steps, every turn, no matter the model: the gate checks, the tools run, the receipt lands.
prompt → gate → tools → receipt
- OS sandboxAppContainer and Job Objects on Windows; linux/macOS backends planned; all native
- Hard deny listrm -rf /, force pushes and disk writes fail in every mode, yolo included
- Hidden checkpointsEach turn commits to refs/coral/*; nothing lands on your branch until you say so
- Budget cap--budget-cents is a hard stop, with a live meter on every line
Built to survive real repositories. The machine enforces the rules.
The rules live in the binary, not in a prompt you have to re-read every run. Ask coral to skip them and the gate answers with a readable refusal.
deny first, ask never
Bring coral into your workflow
coral talks to any OpenAI-compatible endpoint. Point it at a hosted model, a router or a local one through Ollama or llama.cpp; the agent stays the same.
- CORAL_BASE_URLThe endpoint coral calls: api.deepseek.com, OpenRouter, or localhost:11434
- CORAL_MODELWhatever model you already pay for, or run locally for free
- CORAL_API_KEYStays in your environment, never written to config
- Mock modeNo key at all: the CLI, gate and checkpoints still work to try
OpenAI · DeepSeek · Ollama — three pearls, one agent
Decide how far it may go
Four permission modes; the hard-deny list holds in every one. The mode only decides where "ask" sits.
plan → default → accept → yolo
reads only default
asks first accept
writes free yolo
runs free
One Rust binary.
cargo build --release · MIT licence · mock mode without a key · Windows today; linux and macOS next.
Questions
The ones that come up first. read the source
Which models does coral run?
Any OpenAI-compatible endpoint: set CORAL_BASE_URL and CORAL_MODEL, or point it at Ollama or llama.cpp for local models. The README example uses deepseek-chat.
What does coral cost?
coral itself is MIT and free. A typical run on a cheap model lands in cents, and --budget-cents stops it before it can cost more.
Does coral work on Windows?
Natively. AppContainer and Job Objects on Windows; linux/macOS backends planned, the confinement other agents leave to WSL2.
Does coral work without an API key?
It runs in mock mode, so you can poke the CLI, the gate and the checkpoints before spending a cent.
What does coral not do yet?
The AppContainer sandbox is experimental — a known hang on ACL grant in some shells; set sandbox = false to fall back. The gate, checkpoints, receipts and the budget cap already work.
You never yell at it.
A hard gate, a budget in cents and a checkpoint on every turn.