dora memory

Project principles — capture, enforce in review, promote to AGENTS.md.

dora memory <subcommand>

Local project principles that stick across sessions. Review treats them as a rubric. Optional promote writes hard rules into AGENTS.md. Optional sync backs up to a private git repo.

Memory replaced the old journal command. The first dora memory run migrates legacy journal entries once when present.

add

dora memory add "Never use default exports" --weight 8
dora memory add "Run bun test before commit" --tags style,ci --body "CI fails otherwise"
dora memory add "Prefer named exports" --global

Flag	Meaning
`--weight 1–10`	Default `5`. w8 hard rule · w5 default · w3 soft preference
`--tags <csv>`	Comma-separated tags
`--global`	Global memory (shared across projects)
`--body <text>`	Rationale / detail

Title is required, short imperative (≤ 80 chars).

list

dora memory list
dora memory list --format json

context

Output principles for hooks, CLAUDE.md, or piping.

dora memory context
dora memory context --full
dora memory context --json --quiet
dora memory context --append-to CLAUDE.md

Flag	Meaning
`--full`	Full principle body
`--json`	Claude SessionStart hook JSON (`hookSpecificOutput.additionalContext`)
`--quiet`	Omit plain text when empty (still emits JSON with `--json`)
`--append-to <file>`	Append/update a managed section in that file

promote

dora memory promote
dora memory promote --weight 7 --dry-run
dora memory promote --yes

Writes high-weight principles into AGENTS.md (diff + confirm unless --yes).

stash / restore

Copy gitignored or untracked files into project memory (survives a clean clone), then restore later.

dora memory stash path/to/notes.md
dora memory restore path/to/notes.md
dora memory restore --dry-run

sync

dora memory sync
dora memory sync --repo owner/dora-memory

First run creates/clones the private backup repo; later runs commit + pull –rebase + push.