On this page
Remember & reuse
Remember what will matter next.
Keep selected findings and decisions separate from transient reads and conversation history.
Choose the right store
Session state describes the current work: task, progress, findings and decisions. Project knowledge stores facts intended to be useful across tasks. Read caches hold prior source representations.
None of these is a promise to retain every conversation indefinitely. Capacity, lifecycle, retention and project boundaries apply.
Record a useful decision
{"name":"ctx_knowledge","arguments":{"action":"remember","category":"decision","content":"Use the existing authentication middleware for new protected routes. Verify against the current routing configuration before implementation."}}
Prefer a specific, reviewable fact over a large transcript. Include its source or rationale. Avoid storing secrets merely because the knowledge store is local.
Recall, then verify
{"name":"ctx_knowledge","arguments":{"action":"recall","query":"authentication middleware"}}
Recall returns candidates, not a freshness guarantee. Compare the finding with current source, update obsolete knowledge and resolve contradictions deliberately.
Session continuity can include a compact startup briefing. Its placement and contents depend on integration and configuration; it is not unrestricted access to previous host conversations.
Keep knowledge portable
The CLI supports JSON export/import and Open Knowledge Format bundles. OKF represents facts as Markdown with metadata and relationships. Inspect an export before sharing it and preserve project boundaries when importing.
See protocols and formats for the distinction between knowledge exports, runtime packages and versioned SDK checkpoints.
Operate within limits
The memory lifecycle can consolidate, age and archive entries according to the configured capacity. Check configuration for effective limits. Local archives are subject to their own retention and availability.
Sources & versions
- mod.rsrust/src/tools/ctx_knowledge/mod.rsGitHub
- remember.rsrust/src/tools/ctx_knowledge/remember.rsGitHub
- state.rsrust/src/core/session/state.rsGitHub
- 03-memory-and-knowledge.mddocs/reference/03-memory-and-knowledge.mdGitHub
- Core checkout
0ce2207ee4- Installed runtime
- 3.10.2
- SDK release
- 1.1.0
Separate baselines for source, CLI/configuration and SDK contracts. Review does not certify every platform or integration.
Versions & compatibility