Skip to main content

Status

Look at the store, its ledgers and the other projects.

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: Troubleshooting, Team memory.

daimon status​

checkpoint presence/age + last serialize outcome

daimon status [--project PROJECT] [--json] [--suppressed]
argumentvaluedefaultdescription
--projectPROJECTproject directory to check (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output
--suppressedlist items withheld from the briefing as resolved (#103)

Examples

daimon status
daimon status --project . --json

daimon stats​

local usage + capture aggregates (#54): nothing is transmitted; sharing the output is a deliberate paste

daimon stats [--json]
argumentvaluedefaultdescription
--jsonmachine-readable output

daimon log​

append a freeform timeline event (zero-LLM) to this project's event log (#102)

daimon log --text TEXT [--kind KIND] [--status STATUS] [--project PROJECT]
argumentvaluedefaultdescription
--textTEXTwhat happened (required)
--kindKINDnoteevent kind (default: note)
--statusSTATUSoptional free-form status
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)

daimon loops​

list open, briefable loop items with ids for this project (#480): the read counterpart to daimon resolve's write path

daimon loops [--project PROJECT] [--stale]
argumentvaluedefaultdescription
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--stalelist only the carried items past the staleness budget, the set the briefing may drop

Examples

daimon loops
daimon loops --stale
daimon loops --project .

daimon projects​

list every project daimon has a checkpoint for

daimon projects [--project PROJECT] [--json]
argumentvaluedefaultdescription
--projectPROJECTproject directory the current-project mark is computed against (default: DAIMON_PROJECT_DIR, then cwd)
--jsonmachine-readable output

Examples

daimon projects
daimon projects --json

daimon slug​

print the checkpoint directory name daimon derives from a project path

Print the checkpoint directory name daimon derives from a project path. Read-only: no store, config, or ledger access.

daimon slug path
argumentvaluedefaultdescription
pathproject directory path to slug

Examples

daimon slug /Users/x/my.proj
daimon slug -- -Users-x # '--' escapes a path starting with '-'

daimon bucket​

maintain the checkpoint bucket this project reads and writes

daimon bucket <command>
commandwhat it does
migratemove a bucket written before 0.42.0 into the one daimon reads

daimon bucket migrate​

move a bucket written before 0.42.0 into the one daimon reads

Move the bucket a pre-0.42.0 daimon wrote for this project into the bucket this daimon reads. Affects a project whose path carries a symlink component, or one below a git toplevel: before 0.42.0 the library slugged the literal path. A pointer already in the current bucket is never removed or displaced. Safe to run twice: a second run over an unchanged state writes nothing new and returns the code matching the state it finds.

daimon bucket migrate [--project PROJECT] [--dry-run] [--json]
argumentvaluedefaultdescription
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--dry-runprint the plan and write nothing
--jsonmachine-readable output

Examples

daimon bucket migrate
daimon bucket migrate --project /tmp/my-repo --dry-run

daimon ledger​

look after a bucket ledger file (#1132)

daimon ledger <command>
commandwhat it does
repairrejoin split rows, move torn and garbage lines to <name>.quarantined-lines, and re-run forget over the ledger

Examples

daimon ledger repair trust --dry-run
daimon ledger repair events

daimon ledger repair​

rejoin split rows, move torn and garbage lines to <name>.quarantined-lines, and re-run forget over the ledger

daimon ledger repair name [--project PROJECT] [--dry-run]
argumentvaluedefaultdescription
namea bucket ledger: events, refutations, amendments, requests, verification, worldcheck-outcomes, forget-hits, relations, trust, request_policy_tombstones
--projectPROJECTproject directory (default: DAIMON_PROJECT_DIR, then cwd)
--dry-runreport what would change and write nothing

daimon team​

shared team memory: sidecar repo init/sync/status (#113)

daimon team <command>
commandwhat it does
initclone the private team sidecar repo (empty remote OK)
synccommit+push own checkpoints; fetch teammates' only on remote change (ls-remote gate)
statusper-remote freshness, own unpushed count, authors seen

Examples

daimon team init git@github.com:org/team-memory.git
daimon team sync
daimon team status

daimon team init​

clone the private team sidecar repo (empty remote OK)

daimon team init remote_url
argumentvaluedefaultdescription
remote_urlgit remote URL of the PRIVATE team repo

daimon team sync​

commit+push own checkpoints; fetch teammates' only on remote change (ls-remote gate)

daimon team sync [--project PROJECT] [--apply-forget]
argumentvaluedefaultdescription
--projectPROJECTaccepted for CLI symmetry; sync is currently project-agnostic (all own checkpoints sync regardless of project)
--apply-forgetalso rewrite THIS machine's checkpoints under teammates' forget tombstones (#600). Requires DAIMON_TEAM_APPLY_FORGET=1; typed only: the SessionStart hook spawns a bare sync, so this can never delete your belief state unattended. Without the standing consent, refuses at rc 2 before syncing anything

daimon team status​

per-remote freshness, own unpushed count, authors seen

daimon team status [--json]
argumentvaluedefaultdescription
--jsonmachine-readable output