Status
Look at the store, its ledgers and the other projects.
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]
| argument | value | default | description |
|---|---|---|---|
--project | PROJECT | project directory to check (default: DAIMON_PROJECT_DIR, then cwd) | |
--json | machine-readable output | ||
--suppressed | list 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]
| argument | value | default | description |
|---|---|---|---|
--json | machine-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]
| argument | value | default | description |
|---|---|---|---|
--text | TEXT | what happened (required) | |
--kind | KIND | note | event kind (default: note) |
--status | STATUS | optional free-form status | |
--project | PROJECT | project 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]
| argument | value | default | description |
|---|---|---|---|
--project | PROJECT | project directory (default: DAIMON_PROJECT_DIR, then cwd) | |
--stale | list 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]
| argument | value | default | description |
|---|---|---|---|
--project | PROJECT | project directory the current-project mark is computed against (default: DAIMON_PROJECT_DIR, then cwd) | |
--json | machine-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
| argument | value | default | description |
|---|---|---|---|
path | project 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>
| command | what it does |
|---|---|
migrate | move 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]
| argument | value | default | description |
|---|---|---|---|
--project | PROJECT | project directory (default: DAIMON_PROJECT_DIR, then cwd) | |
--dry-run | print the plan and write nothing | ||
--json | machine-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>
| command | what it does |
|---|---|
repair | rejoin 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]
| argument | value | default | description |
|---|---|---|---|
name | a bucket ledger: events, refutations, amendments, requests, verification, worldcheck-outcomes, forget-hits, relations, trust, request_policy_tombstones | ||
--project | PROJECT | project directory (default: DAIMON_PROJECT_DIR, then cwd) | |
--dry-run | report what would change and write nothing |
daimon team
shared team memory: sidecar repo init/sync/status (#113)
daimon team <command>
| command | what it does |
|---|---|
init | clone the private team sidecar repo (empty remote OK) |
sync | commit+push own checkpoints; fetch teammates' only on remote change (ls-remote gate) |
status | per-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
| argument | value | default | description |
|---|---|---|---|
remote_url | git 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]
| argument | value | default | description |
|---|---|---|---|
--project | PROJECT | accepted for CLI symmetry; sync is currently project-agnostic (all own checkpoints sync regardless of project) | |
--apply-forget | also 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]
| argument | value | default | description |
|---|---|---|---|
--json | machine-readable output |