Memory commands

The Memory group manages cross-session and team memory. All of it converges on the proof-carrying ledger under .forge/ledger/. See Proof-carrying memory for the model.

`forge cortex`

Self-correcting project memory — lessons mined from corrections.

forge cortex status        # what's been learned
forge cortex why <symbol>  # why a lesson applies here

`forge recall`

Manage cross-session personal memory.

forge recall list          # facts the recall-load guard injects next session
forge recall add "db port" "Postgres is on 5433 here, not 5432"
forge recall consolidate   # summarize (advisory, human-reviewable)

`forge remember`

Add a durable, repo-committable fact to this repo’s portable memory.

forge remember "<fact>"

`forge brain`

Show or rebuild the portable project-memory index.

forge brain                # show the index
forge brain --rebuild      # rebuild it

`forge ledger`

Proof-carrying memory — the content-addressed claim store.

forge ledger stats                 # what the repo knows, by kind and trust level
forge ledger verify                # re-check claims are in normal form
forge ledger show <id>             # a claim and its evidence
forge ledger blame <id-prefix>     # who minted it, every oracle outcome, per-author trust
forge ledger query "<text>"        # retrieve by relevance
forge ledger at <date>             # beliefs as of any past day — recomputed, never guessed
forge ledger diff <since> [<until>]  # appeared / retired / strengthened / weakened
forge ledger root                  # Merkle root over the verified state (sync fast path)
forge ledger ratify <id>           # human accept
forge ledger retract <id>          # tombstone a claim
forge ledger merge <path>          # fold a teammate's ledger in, conflict-free
forge ledger import                # back-fill pre-ledger history into the ledger

Add --personal for the per-user ledger.

`forge reuse`

Proof-carrying code cache — served only when its evidence still holds.

forge reuse query "<spec>"                 # verified code you already have
forge reuse mint "<spec>" --file <path>    # add an artifact to the cache
forge reuse stats                          # cache stats

`forge handoff`

Bounded session snapshot — rewrites .forge/state.md, re-injected each session start.

forge handoff "<what's done>" --next "<what's next>"

`forge decide`

Append-only decision log — D-#### ADR-lite entries in .forge/decisions.md.

forge decide "<decision> — <reason>"
forge decide                 # read the log before re-deciding

`forge know`

Route a fact to its correct storage home — decides whether a piece of knowledge belongs in recall, remember/brain, a decision, or a cortex lesson, and files it there.

forge know "<fact>"

`forge deja`

Similar-past-work lookup — surfaces prior work in the ledger that resembles what you’re about to do, so you reuse the proof instead of regenerating.

forge deja "<what you're about to build>"

​forge cortex

​forge recall

​forge remember

​forge brain

​forge ledger

​forge reuse

​forge handoff

​forge decide

​forge know

​forge deja