Kopeng

KOPENG

[](https://github.com/djy89/kopeng/actions/workflows/ci.yml)    

**Persistent, self-curating memory for coding agents — it doesn't just remember what you've done, it cleans up after itself, fully local.**

KOPENG 0.x is a **local developer preview**: a self-hosted memory system for a single expert developer, on one machine, bound to loopback. Every autonomous layer ships OFF and is labeled advanced. What backs reliability is engineering rigor, not scale — a zero-LLM pinned-clock replay regression net, adversarial GATE reviews run against a *copy* of real data, idempotent locked consolidation passes, and fail-open/fail-silent behavior everywhere a hook or service could stall.

Renamed 2026-07 to its current codename. Everything now uses `kopeng` — hook env vars are `KOPENG_*` and the client data directory is `~/.kopeng/`.

KOPENG is a memory and context layer for coding agents (Claude Code, Codex CLI), exposed as MCP tools plus a REST API. It learns from observed tool-use — passively turning repeated tool calls, error-then-fix patterns, hot files, and cross-session sequences into confidence-scored memories with no LLM cost — and serves them back through a hybrid retrieval pipeline (RRF fusion of semantic + keyword, optional cross-encoder rerank, confidence-blended ranking), all running on local quantized ONNX models so there is no per-query API cost or data egress. Its distinguishing layer is operator-gated nightly consolidation (the "dreaming Librarian"): a deterministic-first engine that collapses duplicate memories, decays stale ones, and routes contradictions and supersessions — every mutati