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.

$ cargo build --release
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

See the config

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

Action plan
reads only
default
asks first
accept
writes free
yolo
runs free
Read files allowallowallowallow
Write and edit denyaskallowallow
Run commands denyaskaskallow
rm -rf /, force push, disk writes denydenydenydeny

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

Ask something else

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.