v3.1.8 — First public release
.knowledge v3.1.8 — First public release
Historical install note: For installation, use the uploaded GitHub Release asset attached to this release. Do not use GitHub "Download ZIP" or autogenerated "Source code" archives as install packages. New installs should prefer the latest release.
.knowledge is an open local control plane for AI coding agents.
It gives Codex, Claude Code, OpenCode and custom agents one repo-local memory layer: routing bundle, trust and freshness status, repair queue, scoped local search, source-of-truth rules and Visual Inspector.
Highlights
- One first-read routing bundle
- Trust and freshness status
- Repair queue
- Scoped local search
- Source-of-truth rules
- Visual Inspector
- Cookbook flows
- Official templates
- Codex, Claude Code and OpenCode integrations
- Pinecone Local / Cloud bridge, disabled by default
- Optional advisory update checks, disabled by default
- Apache-2.0 core
Install
Download .knowledge.zip, extract it into your repository root, then tell your agent:
Read `.knowledge/Quick-Start.md` and execute it for this repository.Manual setup:
node .knowledge/tools/install-agent-integrations.js
node .knowledge/tools/flow.js import
node .knowledge/tools/flow.js release --no-colorAfter setup, the first operational file an agent reads is:
.knowledge/maintenance/routing_bundle.jsonQuick metrics
In a synthetic SaaS-shape fixture:
- 14 orientation files → 1 routing bundle
- ~22% less first-orientation context
- Doctor: healthy 90–93 depending on scenario
These numbers are order-of-magnitude estimates from one local estimator, not tokenizer-verified production benchmarks. Tiny repositories may show overhead because the routing bundle has fixed structure cost.
Update checks
Update checks are disabled by default.
.knowledge does not run a background updater, does not send telemetry and does not apply updates automatically.
Manual check:
node .knowledge/tools/check-updates.jsOptional weekly advisory checks:
node .knowledge/tools/check-updates.js --enable --interval=7dNotes
- External memory is a bridge, not source of truth.
- Current source code and tests always beat summaries.
- The bundled Visual Inspector is local, static and free.
- Pro2Pilot Inspector will be the future interactive/team layer.