kapi context log

$ kapi log

List what has been proposed, corrected and decided about this project's context, newest first.

Each line carries an operation's id, when it happened, who did it, what it was about and where it stands: a candidate nobody has decided on, a confirmed rule in force, or one that was discarded or reverted.

The id is what the other verbs take. Narrow the list with --status to see what is waiting for a decision, or with --session to see what one agent run did. "--session this" is that run reading back its own work.

Commandcontext log

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 log

Flags

Flag	Type	Default	Description
--actor	string		only one actor, by name or by kind
--limit	int	0	keep the most recent N (0 keeps them all)
--project, -p	string		path to a kapi.yaml project recipe or its directory (auto-discovered from cwd if omitted)
--session	string		only what one agent session recorded, or "this" for the session this run records under
--since	string		only what happened after a date (2006-01-02) or instant
--status	string		only operations at one status: candidate, confirmed, discarded or reverted
--subjects	bool	false	only what was proposed, leaving out the decisions about it

More examples

$ kapi context log --status candidate

$ kapi context log --session 0ab4e399 --json

$ kapi context log --session this

$ kapi context log --actor agent --since 2026-09-01

← Back to the Command Reference