Skip to content

Human Review

Your agents record decisions as they work. loomtracer review lets you look over them afterwards, one by one, in the terminal: no need to watch the agents live or read their transcripts.

Terminal window
loomtracer review --actor 'agent:*' --since 7d --unreviewed-only

--unreviewed-only leaves out what you have already approved, disagreed with or replaced. You are recorded as the reviewer (Setting the actor). Each decision is shown with its reason, options and what it rests on, and you choose:

KeyVerbWhat it records
aapproveYou accept the decision.
ddisagreeYou dispute it, with a reason. A decision someone accepted now reads contested, with both sides kept.
ssupersedeYou replace it: a new title, the reason, and the options. The old one reads superseded and points to the new one.
nnextNothing. It stays unreviewed.
qquitStop here.

A decision your agent records with a chosen option is accepted at once, by whoever decided it. Reviewing it is still yours to do. Decisions imported from documents start as proposed until you approve them.

You can disagree with or replace any decision at any time. Describe it instead of quoting an id:

Terminal window
loomtracer disagree "sqlite for the ledger" --reason "Two people will write to it from their laptops"
loomtracer supersede "sqlite for the ledger" \
--title "Use Postgres for the ledger" \
--rationale "Two people write to it from their laptops, so one file on one machine no longer works" \
--topic-keys storage --options postgres,sqlite --chose postgres \
--rests-on-evidence "Two people write to the ledger from their laptops" --evidence-source "team chat, 2 Oct" \
--binds "Every later write goes to one Postgres server" --undo-cost "Moving the data back to one file"

A description that matches more than one decision lists the candidates, numbered, and writes nothing; pick one with --pick <n>. Like a new decision, a replacement must say what it rests on, what it binds and what undoing it would cost. Nothing is edited or deleted: the old decision stays in the record, and loomtracer query chain follows the replacements back to the first one.

Terminal window
# What your agents decided this week, one line each
loomtracer query recent --actor 'agent:*' --since 7d --summary
# Every disputed decision
loomtracer query search_decisions --status contested --summary