CLI reference
| Command | Description |
|---|---|
deja "query" | Search indexed history. Filters: --harness --project --since --role --re --json. |
deja ctx "query" | Print a context digest to stdout (for piping into an agent). |
deja blame <path> | Sessions that discussed a file, most specific first. |
deja remember "text" | Store a durable note. --project optional; --tag (repeatable) attaches keywords that boost matching queries. |
deja forget | Remove sessions by --session/--project/--before; --dry-run, --list, --unforget. |
deja stats | Totals, top projects, activity. --card (SVG), --html (timeline), --redaction, --json. --impact prints the measured impact report (recalls, reuse, distillation ratio) with the arithmetic labeled. |
deja | Bare, on a terminal: the living brief — today's activity, recalls served, déjà vu moments, a suggested search from your own history. |
deja log | Audit trail: recent recalls and injections; --last prints the most recent injected digest verbatim; --json. |
deja last [n] | Recent sessions. --project, --harness, --since, --role. |
deja sources | Discovered stores per harness, with redaction counts. |
deja install <target|--all|--auto> | Wire MCP recall (and hooks) into your agents. |
deja embed | Build the semantic vector sidecar from a local endpoint. |
deja sync export/import/ssh | Move redacted memory between machines. |
deja promote <id> | Distill a session into a curated note: quoted evidence with provenance and a lifecycle state (--state accepted|rejected|superseded|stale). Corrections append; the note outranks the raw transcript in recall. --to path also appends a Markdown block for repo-visible notes. --tag adds keywords; promoting into ground another accepted note already covers prints a conflict warning naming the older note. |
deja view | Browse memory in one self-contained local HTML: sessions with previews, recall audit trail, curated notes. --out path, --no-open. |
deja doctor | Diagnose stores, wiring, index and version. --json, --offline. --deep re-parses a sample of source files and resolves postings to prove the index against the sources; exits non-zero on drift. |
deja bench recall|context | Reproducible search-quality and context-readiness benchmarks. |
deja update | Update a standalone install (Homebrew/npm update via the package manager). |
Run
deja with no arguments for the usage summary, or any command with its flags. Everything is offline except update, sync ssh and the doctor version check.