Tooling
Configuration & CLI
Configuration header
Configuration can be declared in a header at the top of a .aug file, read before the program runs.
| Header | Default | Effect |
|---|---|---|
oracle "name" | "fake" | Which provider to use. |
model "id" | per-provider | The model id. |
temperature N | 0.7 | Default divination temperature. |
budget N | 1000 | Max oracle calls before aborting. |
oracle "anthropic"
model "claude-haiku-4-5"
temperature 0.4
budget 200
proclaim divine "a haiku about determinism"CLI flags override the file header, which overrides the built-in defaults.
CLI reference
aug <file.aug | -> [options] # - reads the program from stdin| Flag | Description |
|---|---|
--seance | Start the interactive REPL. |
--paranoid | Log every oracle call (operation, operands, response, tokens) to stderr. |
--quiet | Suppress the end-of-run cost summary. |
--oracle <name> | anthropic | openai | openrouter | ollama | fake. |
--model <id> | Override the model. |
--temperature <n> | Override the default temperature. |
--budget <n> | Override the oracle-call ceiling. |
--remember | Cache divinations to disk for reproducible, cheaper re-runs. |
--remember-file <path> | Cache file path (default .augur-cache.json). |
--retry <n> | Retries on a transient oracle error (default 2). |
-v, --version | Print the version. |
When a run makes at least one oracle call, a cost summary is printed to stderr:
You spent R$0.0123 on 4 divination(s) - 512 in / 96 out tokens (claude-haiku-4-5).