| name | cortex-memory |
| version | 1.0.0 |
| description | Persistent cognitive memory for AI agents — query, record, review, and consolidate knowledge across sessions with spreading activation, FSRS scheduling, and NLI contradiction detection. |
| author | idapixl |
| tags | ["memory","cognition","mcp","agents","knowledge-graph","spaced-repetition","code-review","fsrs"] |
Cortex Memory
Persistent memory engine for AI agents. Knowledge survives across sessions — recall what you learned last week, track evolving beliefs, detect contradictions, and build a knowledge graph over time.
Source: github.com/Fozikio/cortex-engine (MIT) | npm
Prerequisites
This skill requires cortex-engine running as an MCP server. Install it separately before using this skill:
npm install @fozikio/cortex-engine@0.5.1
Then initialize and start:
npx @fozikio/cortex-engine@0.5.1 fozikio init my-agent
npx @fozikio/cortex-engine@0.5.1
Runs locally with SQLite + Ollama. No cloud accounts needed. The skill instructions below are read-only — they teach your agent how to use cortex tools, they don't execute anything.
Core Loop
Read before you write. Always check what you already know before adding more.
Search
query("authentication architecture decisions")
Be specific. query("JWT token expiry policy") beats query("auth"). Results include relevance scores and connected concepts.
Explore around a result:
neighbors(memory_id)
Record
Facts — things you confirmed:
observe("The API rate limits at 1000 req/min per API key, not per user")
Questions — unresolved:
wonder("Why does the sync daemon stall after 300k seconds?")
Hypotheses — unconfirmed ideas:
speculate("Connection pooling might fix the timeout issues")
Update beliefs
believe(concept_id, "Revised understanding based on new evidence", "reason")
Track work across sessions
ops_append("Finished auth refactor, tests passing", project="api-v2")
ops_query(project="api-v2") # pick up where you left off
Memory-Grounded Reviews
Review code or designs by comparing against accumulated knowledge:
- Ground:
query("the domain being reviewed") — load past decisions and patterns
- Compare: Does the work align with or diverge from established patterns?
- Record:
observe() new patterns, wonder() about unclear choices, believe() updated understanding
- Output:
## Review — Grounded in Memory
### Aligned with known patterns
- [matches cortex context]
### Divergences
- [what differs, intentional or accidental]
### New patterns to capture
- [novel approaches worth observing]
Session Pattern
- Start:
query() the topic you're working on
- During:
observe() facts, wonder() questions as they come up
- End:
ops_append() what you did and what's unfinished
- Periodically:
dream() to consolidate memories (compress, abstract, prune)
Available Tools
| Category | Tools |
|---|
| Read | query, recall, predict, validate, neighbors, wander |
| Write | observe, wonder, speculate, believe, reflect, digest |
| Ops | ops_append, ops_query, ops_update |
| System | stats, dream |
