memory¶
Manage the persistent memory layer — a SQLite database that stores findings across all your reviews and surfaces recurring patterns.
Usage¶
No setup needed for consolidation
Consolidation fires automatically in the background on any claude-review command invocation once the time or volume trigger is met. The start/stop/install subcommands are optional — useful only for always-on machines where you want consolidation to run even between active uses.
Subcommands¶
| Subcommand | Description |
|---|---|
status |
Show DB statistics and last consolidation time |
clear |
Delete all stored findings from the database |
start |
Start the optional background consolidation daemon |
stop |
Stop the running daemon |
install |
Install the daemon as a system service (launchd on macOS, systemd on Linux) |
Examples¶
Check memory status¶
Output:
Daemon: not running (on-wake consolidation is active)
Findings stored: 47 (accepted: 47)
Consolidations: 5
False positives: 2
Last consolidation: 2026-03-11 15:20
Clear all stored data¶
Warning
This permanently deletes all stored findings, consolidations, and false positive records for the current repo. There is no undo.
Optional: start the background daemon¶
For always-on machines (CI servers, developer workstations that never sleep):
Optional: install as a system service¶
On macOS, installs a launchd plist so the daemon starts automatically on login:
On Linux, installs a systemd user service:
claude-review memory install
systemctl --user enable claude-review-memory
systemctl --user start claude-review-memory
Stop the daemon¶
Using memory during reviews¶
Pass --memory to any review command:
This does two things:
- Before the review: queries the memory DB for findings in the files being changed, groups them into hotspots, fetches recent consolidated insights, and injects the context block into every finder agent's prompt
- After the review: stores all new findings in the DB for future use
Additionally, on every claude-review command (with or without --memory), the on-wake consolidation check runs and fires a background consolidation if the trigger conditions are met.