Record a decision, with why

What you get: decisions that carry their reasons. When an agent, or a new colleague, asks “why do we do it this way?”, the answer is there, with the alternatives you rejected.

Ask Quox

Just ask, in your own words:

quox · talking to Quox Copy

› What did we decide about the output shown in the cli.quox.ai guides, and why?

▤ AOCL │ L1 identity complete · allowed · 0ms

▤ AOCL │ L3 policy gate complete · proceed · 10ms

◐ BRAIN │ search ✔ BRAIN │ search │ ok · 2.7s

◐ BRAIN │ read ✔ BRAIN │ read │ ok · 904ms

⛓ AEE │ envelope opened · stream_success

Here's the full picture.

Decision: cli.quox.ai guides show real output, with names changed [B6]

The guides use output captured from actual runs, but with private names swapped out. The reasoning was straightforward: a reader should see the true shape of every screen, so fabricated example output was explicitly rejected. The concern was that invented output could misrepresent what Quox actually produces, whereas real output (minus the private identifiers) gives an accurate picture without exposing internal names.

Captured from commit fc72831 on the cli.quox.ai repo, recorded today.

20.9s · 2 tools · 0 approvals

A real turn on our own install (quox 0.3.0, 13 Oct 2026), replayed at speed. Names changed. Type the same words into quox.

Recording a decision is a command (below). Asking gets it back later, with the reasons and what was rejected.

Do it yourself

1. Try it without saving

--dry-run prints the note that would be saved, and saves nothing:

a decision, dry run Copy

$ quox brain decide "Guides show real output with names changed" \    --why "a reader should see the true shape of every screen" \    --rejected "invented example output" --dry-run# Decision: Guides show real output with names changed Kind: decision ### WhatGuides show real output with names changed ### Whya reader should see the true shape of every screen ### Rejected alternatives- invented example output ### Provenance- at: 2026-10-13T20:37:56.425Z 🌌 QORTEX │ decide │ dry run, nothing saved

From a real run on our own install.

2. Save it

Drop --dry-run. Before saving, Quox checks the brain for a decision that already says the same thing, and stops if it finds a strong match, so you do not end up with two versions. --force saves anyway.

quox brain decide "Releases need a second approver" --why "one person can miss a risky change" --rejected "owner approves alone" --scope org --tags release,policy

--scope private (the default) keeps it to you; --scope org shares it with your organisation and its agents.

What just happened

The decision was saved as a structured note: what, why, what was rejected, and when. Search finds it like any other note, and agents that search before answering can cite it. quox brain citations shows what agents cited.

Check it yourself

quox brain search "second approver"

Undo

Decisions change; record the new one, and say why the old one no longer holds. Put a wrong belief right shows how a change is kept as history rather than erased.

Next

• Put a wrong belief right