Skip to content

v0.1.0 — first public release

Latest

Choose a tag to compare

@KanishkNoir KanishkNoir released this 23 Jul 18:15

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.