Skip to main content

Check

Ask why an item is trusted and prove what the store promises.

note

This page is generated from the CLI's argument parsers. Do not edit it: change the flag or its help text in the code, then run UPDATE_DOCS_REFERENCE=1 uv run pytest tests/test_docs_generated.py from plugin/.

See also: Inspect an item, Trust classes, Receipts, Viewer, Relations.

daimon why​

inspect the evidence and lifecycle receipt for one item

daimon why item_id [--source] [--json] [--project PROJECT] [--slug SLUG]
argumentvaluedefaultdescription
item_idexact item id shown by daimon recall or daimon loops
--sourceshow one bounded, redacted message-level source window
--jsonmachine-readable evidence axes
--projectPROJECTproject directory to scope to (default: DAIMON_PROJECT_DIR, then cwd)
--slugSLUGscope to a project bucket by its slug (see daimon projects)

Examples

daimon recall retry policy
daimon why o-3f8a2c
daimon why o-3f8a2c --source --json

daimon diff​

what changed between two retained checkpoints of this project (#975): added, restated, re-tagged, and every item the chain stopped carrying, with the reason the record gives

Compare two retained checkpoints of one project and report every item that changed. Read-only: it stamps nothing. Rollback is a non-goal: a checkpoint records what a session did, so restoring one would assert a different past; use forget, resolve or reverify to say so on the record instead.

daimon diff [--from N] [--to M] [--json] [--project PROJECT] [--slug SLUG]
argumentvaluedefaultdescription
--fromNthe OLDER endpoint, in generations back: 0 is latest.json, 1 is prev-1.json (default: the latest readable pair)
--toMthe NEWER endpoint, same numbering; must be smaller than --from
--jsonmachine-readable change rows
--projectPROJECTproject directory to scope to (default: DAIMON_PROJECT_DIR, then cwd)
--slugSLUGscope to a project bucket by its slug (see daimon projects)

Examples

daimon diff
daimon diff --from 2 --to 0
daimon diff --json

daimon blame​

how one item got here (#975): the session that first stated it, every carry since, and every event that changed its state, in order

Trace one item through this project's retained checkpoint chain. daimon why answers where a claim came from; this answers how it got here. Read-only, and there is no restore: a forgotten item keeps its tombstone here and never its text.

daimon blame item_id [--json] [--project PROJECT] [--slug SLUG]
argumentvaluedefaultdescription
item_idexact item id shown by daimon recall, daimon loops or daimon diff
--jsonmachine-readable lineage
--projectPROJECTproject directory to scope to (default: DAIMON_PROJECT_DIR, then cwd)
--slugSLUGscope to a project bucket by its slug (see daimon projects)

Examples

daimon blame o-3f8a2c
daimon blame o-3f8a2c --json

daimon verify-receipt​

verify a checkpoint's signed provenance receipt via the vitni CLI (#204)

daimon verify-receipt [[session_id]] [--project PROJECT]
argumentvaluedefaultdescription
[session_id]session id to verify (default: this project's latest checkpoint)
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

Examples

daimon verify-receipt
daimon verify-receipt <session-id>

daimon audit​

read-only auditors that verify stored guarantees

daimon audit <command>
commandwhat it does
quotesre-check stored verbatim quotes against their source transcripts and report mismatches (read-only, never rewrites tags, #125; exit 0 checked clean, 1 mismatch, 3 nothing checkable)
privacyprove no forgotten value's plaintext survives on any surface (read-only; exit 0 clean, 1 residue, 3 cannot-prove)

daimon audit quotes​

re-check stored verbatim quotes against their source transcripts and report mismatches (read-only, never rewrites tags, #125; exit 0 checked clean, 1 mismatch, 3 nothing checkable)

daimon audit quotes [--project PROJECT] [--all] [--top TOP] [--json]
argumentvaluedefaultdescription
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--allaudit every project's checkpoints, not just the current one
--topTOP10how many failing quotes to list (default: 10)
--jsonmachine-readable output; lists EVERY failure, where the printed lines stop at --top

Examples

daimon audit quotes
daimon audit quotes --all --top 20
daimon audit quotes --json

daimon audit privacy​

prove no forgotten value's plaintext survives on any surface (read-only; exit 0 clean, 1 residue, 3 cannot-prove)

daimon audit privacy [--project PROJECT] [--all]
argumentvaluedefaultdescription
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--allaudit every local project, each against its own tombstone set

Examples

daimon audit privacy
daimon audit privacy --all

daimon audit-quotes​

daimon audit-quotes [--project PROJECT] [--all] [--top TOP]
argumentvaluedefaultdescription
--projectPROJECT
--all
--topTOP10

daimon serve​

serve the read-only local viewer (localhost only)

Serve the read-only local viewer on localhost. Every surface renders an existing engine's output; nothing writes.

daimon serve [--data-dir DATA_DIR] [--project-dir PROJECT_DIR] [--port PORT] [--no-browser]
argumentvaluedefaultdescription
--data-dirDATA_DIRcheckpoint dir (default: DAIMON_CHECKPOINT_DIR, then ~/.daimon/checkpoints)
--project-dirPROJECT_DIRproject directory to scope to (default: cwd)
--portPORTport to bind (default: 7717)
--no-browserdon't open a browser tab

Examples

daimon serve
daimon serve --port 7800 --no-browser

daimon relations​

inspect and decide typed item relations (#678, shadow mode)

daimon relations <command>
commandwhat it does
listcandidates first; endpoint texts resolved at read time
showone relation with its proposal history
confirmrecord a human confirmation of a candidate edge (human-only: needs an interactive terminal)
rejectrecord a human rejection; sticky against re-proposal (human-only: needs an interactive terminal)
retractundo a confirmation; a fresh proposal may revive it (human-only: needs an interactive terminal)

Examples

daimon relations list
daimon relations show rel-0123456789abcdef
daimon relations confirm rel-0123456789abcdef

daimon relations list​

candidates first; endpoint texts resolved at read time

daimon relations list [--state candidate|confirmed|rejected|retracted] [--project PROJECT] [--json]
argumentvaluedefaultdescription
--statecandidate|confirmed|rejected|retractedfilter by state; repeatable (default: all)
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output

daimon relations show​

one relation with its proposal history

daimon relations show relation_id [--project PROJECT] [--json]
argumentvaluedefaultdescription
relation_idexact rel-… id
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output

daimon relations confirm​

record a human confirmation of a candidate edge (human-only: needs an interactive terminal)

daimon relations confirm relation_id [--project PROJECT]
argumentvaluedefaultdescription
relation_idexact rel-… id
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon relations reject​

record a human rejection; sticky against re-proposal (human-only: needs an interactive terminal)

daimon relations reject relation_id [--project PROJECT]
argumentvaluedefaultdescription
relation_idexact rel-… id
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon relations retract​

undo a confirmation; a fresh proposal may revive it (human-only: needs an interactive terminal)

daimon relations retract relation_id [--project PROJECT]
argumentvaluedefaultdescription
relation_idexact rel-… id
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)