kapi context review

$ kapi review

Walk through what has been suggested about how this project writes, and decide about each one: keep it as a rule, drop it, choose a side where two suggestions disagree, or apply a rule more widely than where it was seen.

A suggestion nobody answers keeps advising, so nothing here has to be cleared. A rule you keep is in force from then on: checks fail on it unless it is advisory. Dropping a rule already in force takes it back out.

In a terminal, review asks about each suggestion in turn. Elsewhere it lists what is waiting, with the id each decision takes:

--keep <id> keep a suggestion (repeatable); --use changes what it says --drop <id> drop a suggestion or a rule (repeatable) --choose <id> choose one side where two suggestions disagree --widen-to <where> with --keep: apply it more widely: project, workspace, or a part of where it was seen, such as mode --valid-from <when>, --valid-to <when> with --keep: the rule holds from, and until, a date (2006-01-02) or an instant

--session narrows the review to what one assistant session suggested, and "--session <id> --keep all" keeps everything it suggested that nothing disagrees with.

Reviewing moves your "since you last looked" marker, kept on this machine and never in the project. --peek leaves it where it is.

Commandcontext review

Groupcontext-person

Try it

Runs in your browser against a small sample file. Edit the command before running, or press Run to execute it as shown.

$ kapi context review

Flags

Flag	Type	Default	Description
--advisory	bool	false	with --keep: make the rule report without failing a check (--advisory=false makes it fail)
--choose	string		choose this side where two suggestions disagree: the other side is dropped and this one kept
--drop	stringArray		drop a suggestion or a rule by id (repeatable)
--keep	stringArray		keep a suggestion by id (repeatable); "all" with --session keeps what the session suggested
--note	string		why
--peek	bool	false	leave the "since you last looked" marker where it is
--project , -p	string		path to a kapi.yaml project recipe or its directory (auto-discovered from cwd if omitted)
--session	string		only what one assistant session suggested
--since	string		treat what came after a date (2006-01-02) or instant as new, in place of the marker
--use	string		with one --keep or --choose: change what the rule says to write instead
--valid-from	string		with --keep: the rule holds from this date (2006-01-02) or instant on
--valid-to	string		with --keep: the rule holds until this date (2006-01-02) or instant, not including it
--widen-to	string		with --keep: apply it more widely: "project", "workspace", or a part of where it was seen

More examples

$ kapi context review --session s0ab4e399

$ kapi context review --keep 0n794e2gk7 --keep 0n79gkq853

$ kapi context review --keep 0n794e2gk7 --use "content memory"

$ kapi context review --keep 0n794e2gk7 --widen-to workspace

$ kapi context review --keep 0n794e2gk7 --valid-to 2026-09-01

$ kapi context review --drop 0n794e2gk7 --note "we say it both ways on purpose"

$ kapi context review --choose 0n794e2gk7

$ kapi context review --session s0ab4e399 --keep all

← Back to the Command Reference