# agent-knowledge

**Give your coding agent a knowledge base that gets better over time.**

`agent-knowledge` turns project documents, decisions, notes, and conversations into a portable Markdown wiki that your agent maintains for you. Ask a question and get a cited answer. Add a source and the agent integrates it with what the project already knows. Run a health check and it finds stale claims, contradictions, and orphaned pages before the wiki quietly rots.

Everything stays in your repository as plain Markdown + Git: readable without special tooling, diffable in code review, and portable across agents.

## Install

Via [skills.sh](https://skills.sh) for Claude Code, Cursor, Codex, and 20+ other agents:

```bash npx skills@latest add stjbrown/agent-knowledge ```

Or install it as a Claude Code plugin:

```text /plugin marketplace add stjbrown/agent-knowledge /plugin install agent-knowledge ```

## See it work

Start a knowledge base in any project:

```text /kb-init ```

Then use ordinary prompts:

```text Ingest this architecture decision: we chose Postgres because...

What do we know about authentication, and which sources support it?

What conflicts with our current deployment strategy? ```

The agent extracts durable knowledge, connects it to existing concepts, answers with citations, and files valuable new conclusions back into the bundle. Two explicit commands handle maintenance:

```text /kb-lint # find broken links, stale claims, contradictions, and gaps /kb-visualize # explore the bundle as an interactive graph ```


The [`knowledge/`](./knowledge/) directory is a complete working example. It documents this project using the same format and skills the project provides.

## Why this exists

Most agent "memory" is either retrieval over raw documents or a pile of notes that nobody maintains. The first repeatedly