@e0ipso/ai-knowledge-base
v0.27.0
Published
Builds and maintains a per-repo knowledge base from AI coding sessions, for use with Claude Code.
Maintainers
Readme
@e0ipso/ai-knowledge-base
A team-shared, git-native knowledge base for AI coding sessions on Claude Code, Codex CLI, Cursor, and OpenCode. Knowledge lives in your repo as plain markdown, not in a per-user database on one developer's laptop, so it propagates to teammates through git pull and is reviewable like code in PR diffs and commit history.
No daemons. No services. No external runtimes. Just Node + git.
Your AI conversations produce a steady stream of project-specific knowledge (conventions, gotchas, named modules, decision rationale), and most of it evaporates when the session ends. This tool captures it, asks a human to curate it, commits it to the repo, and injects it back into every future session.
Quick start
npx @e0ipso/ai-knowledge-base init --harnesses claude
npx @e0ipso/ai-knowledge-base doctorThen code normally. When you want to turn captured material into knowledge nodes, run /kb-curate inside your harness session (also /kb-add, /kb-bootstrap). Prefer the in-session skills. They're context-aware and the only path that walks you through conflict resolution. The matching CLI commands (npx @e0ipso/ai-knowledge-base curate, etc.) exist for scripts and CI but skip the interactive parts. New nodes appear in nodes/; review with git diff and commit the ones you want to keep.
Seed from existing docs
If your repo already has READMEs, ADRs, or module docs, seed the KB from them. Inside a harness session:
/kb-bootstrapThe scan walks the repo root, filtered by .kbignore (generated by init, uses gitignore-style syntax). Edit .kbignore to exclude directories you don't want scanned. Review the resulting nodes under nodes/ with git diff and commit the ones you want to keep.
Documentation
Full documentation: https://mateuaguilo.com/ai-knowledge-base
For maintainers of this package itself, see CONTRIBUTING.md.
