whatisgithub

What is agent-knowledge?

stjbrown/agent-knowledge — explained in plain English

Analysis updated 2026-05-18

20HTMLAudience · developerComplexity · 2/5LicenseSetup · easy

In one sentence

Agent-knowledge gives your coding agent a self-maintaining, cited knowledge base stored as plain Markdown in your Git repo, using the open OKF standard so it works across different AI agents.

Mindmap

mindmap
  root((agent-knowledge))
    What it does
      Markdown knowledge base
      Cited answers
      Health checks
    Tech stack
      Markdown
      Git
      Python
      HTML
    Use cases
      Project documentation
      Cited Q and A
      Knowledge graph view
    Audience
      Developers
      Coding agent users

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Turn scattered project docs, decisions, and notes into a searchable, cited knowledge base.

USE CASE 2

Ask your coding agent a question and get an answer with sources instead of a guess.

USE CASE 3

Run a health check to catch contradictions, stale claims, and orphaned notes before they mislead anyone.

USE CASE 4

Visualize your project's knowledge base as an interactive graph.

What is it built with?

MarkdownGitPythonHTML

How does it compare?

stjbrown/agent-knowledgegavrielp1/salary-2045ky1421737671/chatgpt-plus
Stars202020
LanguageHTMLHTMLHTML
Setup difficultyeasyeasyeasy
Complexity2/52/51/5
Audiencedeveloperpm foundergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Installs as skills via npx skills@latest or as a Claude Code plugin, no external services required.

Permissive MIT license for the project, one vendored specification file uses the separate Apache-2.0 license.

So what is it?

Agent-knowledge, nicknamed Janet in its short description, gives an AI coding agent a knowledge base that improves the more you use it. It turns project documents, decisions, meeting notes, and past conversations into a portable wiki written in plain Markdown, stored right inside your project's Git repository. You can ask the agent a question and it answers with citations pointing back to where the information came from. When you add a new source, it folds that information into what the project already knows instead of just filing it away separately. A built in health check finds outdated claims, contradictions between different notes, and pages nothing else links to, so the wiki does not quietly become unreliable over time. Because everything is stored as plain Markdown files tracked by Git, the knowledge base is readable without any special software, easy to review alongside code changes, and can move between different AI agents rather than being locked into one tool. The project follows an open standard called the Open Knowledge Format, created by Google, rather than inventing its own private database or hidden memory system. New information is always added on top of the old rather than silently overwriting history, so you can trace how a piece of knowledge changed over time. The system is organized as a set of skills. Some are triggered automatically by the agent when a task calls for them, such as reading in a new source or answering a question from the knowledge base. Others you trigger yourself by name, like setting up a brand new knowledge base in a project, running a health check on an existing one, or viewing the whole knowledge base as an interactive graph. It installs into agents such as Claude Code, Cursor, and Codex through a shared skills installer, or as a Claude Code plugin. The project is licensed under MIT, with one vendored specification file licensed separately under Apache-2.0.

Copy-paste prompts

Prompt 1
Run /kb-init in this project to scaffold a new OKF knowledge base.
Prompt 2
Ingest this architecture decision into the knowledge base and tell me what it connects to.
Prompt 3
What do we know about authentication in this project, and which sources support it?
Prompt 4
Run /kb-lint on this knowledge base and fix any contradictions or stale claims you find.

Frequently asked questions

What is agent-knowledge?

Agent-knowledge gives your coding agent a self-maintaining, cited knowledge base stored as plain Markdown in your Git repo, using the open OKF standard so it works across different AI agents.

What language is agent-knowledge written in?

Mainly HTML. The stack also includes Markdown, Git, Python.

What license does agent-knowledge use?

Permissive MIT license for the project, one vendored specification file uses the separate Apache-2.0 license.

How hard is agent-knowledge to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is agent-knowledge for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.