# agent-knowledge

agent-knowledge carries project knowledge across sessions and searches earlier agent transcripts. It fits workflows where decisions and context must persist.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 18
- Author: keshrath
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/keshrath/agent-knowledge
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/agent-knowledge

## What it does

agent-knowledge keeps a Markdown knowledge base that can be synced with Git. An agent can retrieve project context, decisions, workflows, errors, and configuration from later sessions. It also indexes transcripts from Claude Code, Cursor, Codex CLI, Aider, Continue.dev, Cline, and OpenCode.

Search combines semantic similarity with TF-IDF ranking. The knowledge graph can connect entries to code structure and validity periods. `knowledge(action: "wakeup")` builds a sectioned context bundle within a token budget, with `800` as the default. The server can flag stale entries and promote session findings into a dated `.dreams/YYYY-MM-DD.md` diary.

Node >= 20 is required to run it. The MCP connection uses `npx`; embedding options include local Hugging Face, OpenAI, Claude/Voyage, and Gemini providers.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add agent-knowledge -- npx -y agent-knowledge
```

### Codex

**Platform CLI**
```bash
codex mcp add agent-knowledge -- npx -y agent-knowledge
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "agent-knowledge": {
            "command": "npx",
            "args": [
                "-y",
                "agent-knowledge"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "agent-knowledge": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "agent-knowledge"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add agent-knowledge npx -y agent-knowledge
```

## When to use it
- carry project decisions into later sessions
- search earlier agent transcripts
- build a focused startup context
- spot entries affected by code changes
- connect knowledge entries to code relationships

## Example prompts
- Save the API structure decision to the project knowledge base.
- Use `knowledge(action: "wakeup")` to prepare context for this session.
- Search the transcripts for the earlier database connection error.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md