First public release. 🎉
CogniKernel gives Claude Code and Codex persistent, structured project memory — the decisions, constraints, and abandoned approaches worth keeping are captured automatically and injected back at the start of each session, so the agent stops re-deciding what you already decided. No LLM in the loop: memory is built by two small fine-tuned encoder models running locally on CPU in milliseconds.
Install
pip install cognikernel
cognikernel init .
cognikernel install-heads # fetches the fine-tuned encoder bodies (~255 MB, sha256-verified)On PyPI: https://pypi.org/project/cognikernel/0.1.0/
What's inside
- Event-sourced SQLite memory (typed decisions / constraints / do-not-retry graveyard) with latest-wins supersession
- Lexical-primary hybrid retrieval (FTS5 BM25 ∪ optional dense → RRF)
- Four fail-open hook surfaces + an AST skeleton ranked by PageRank
- Cross-platform: one store shared between Claude Code and Codex
- Two fine-tuned encoders (salience + supersession) — classification, not generation, so zero per-session API cost
Schema v18 · CI: lint + full suite on Ubuntu (3.11/3.12) + Windows.