MCP.so
Sign In

TokenKnows — distill AI coding sessions into weekly reports, ADR…

@johnnywuj81

Repository

About TokenKnows — distill AI coding sessions into weekly reports, ADR…

Distill AI coding sessions (Claude Code / Codex / Cursor) into weekly reports, ADRs, incident reviews and a knowledge graph — local-first, evidence-linked.

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "tokenknows": {
      "command": "python3",
      "args": [
        "-m",
        "venv",
        ".venv",
        "&&",
        ".venv/bin/pip",
        "install",
        "-e",
        ".[dev]"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is TokenKnows?

TokenKnows automatically captures AI coding sessions (from tools like Claude Code, Codex, and Cursor) and distills them into structured knowledge assets such as weekly reports, ADRs, and a knowledge graph. It is for developers who want to preserve decisions and insights from AI pair-programming sessions.

How to use TokenKnows?

Install the TokenKnows backend (FastAPI) and web UI, then add the MCP plugin for your AI tool (Claude Code, Codex, Cursor, or VS Code). The plugin provides MCP tools like submit_session_events and distill_document, plus slash commands like /tokenknows:weekly. Run the backend with uvicorn app.main:app and frontend with npm run dev.

Key features of TokenKnows

  • Captures AI coding sessions from Claude Code, Codex, Cursor, and more.
  • Distills into seven asset types including weekly reports, ADRs, and incident reviews.
  • Every paragraph traces back to original PR, conversation, or commit.
  • Local-first with three-layer LLM egress gate for privacy.
  • Can run fully offline with Ollama and zero cloud keys.
  • All collectors run locally without webhooks or tunnels.

Use cases of TokenKnows

  • Automatically generate weekly reports from AI coding sessions.
  • Create Architecture Decision Records (ADRs) from design discussions.
  • Produce incident reviews with evidence from PRs and commits.
  • Build a knowledge graph of entities from multiple sessions.
  • Reusable agent skills (SKILL.md) for future automation.

FAQ from TokenKnows

Which AI tools does TokenKnows support?

It captures sessions from Claude Code, Codex, Cursor, VS Code, GitHub (PRs/commits/issues), and local documents.

Does TokenKnows require cloud LLM keys?

No. It can run fully locally with Ollama; optional cloud providers (Anthropic, OpenAI, MiniMax) require all three egress switches to be on.

How are citations ranked in documents?

Citations are ranked by cosine × trust × recency, requiring at least two distinct sources. Each paragraph links back to the original evidence.

Is TokenKnows local-first?

Yes. Zero egress by default; a three-layer LLM egress gate (instance, project, task) controls any cloud calls, with full audit logging.

What platforms are supported?

macOS provides a full experience with auto-starting collectors. Linux runs backend, frontend, and collectors manually. Windows is untested; WSL2 is recommended.

Frequently asked questions

Which AI tools does TokenKnows support?

It captures sessions from Claude Code, Codex, Cursor, VS Code, GitHub (PRs/commits/issues), and local documents.

Does TokenKnows require cloud LLM keys?

No. It can run fully locally with Ollama; optional cloud providers (Anthropic, OpenAI, MiniMax) require all three egress switches to be on.

How are citations ranked in documents?

Citations are ranked by `cosine × trust × recency`, requiring at least two distinct sources. Each paragraph links back to the original evidence.

Is TokenKnows local-first?

Yes. Zero egress by default; a three-layer LLM egress gate (instance, project, task) controls any cloud calls, with full audit logging.

What platforms are supported?

macOS provides a full experience with auto-starting collectors. Linux runs backend, frontend, and collectors manually. Windows is untested; WSL2 is recommended.

Comments

Basic information

Category

Memory & Knowledge

License

MIT

Author

johnnywuj81

More Memory & Knowledge MCP servers

Context7 MCP - Up-to-date Docs For Any Cursor Prompt

upstash

Context7 Platform -- Up-to-date code documentation for LLMs and AI code editors

58.7K

Ultimate Google Docs & Drive MCP Server

a-bonus

The Ultimate Google Docs, Sheets, Drive, Gmail, & Google Calendar MCP Server. This MCP (primarily for use in Claude Desktop) gains full access to your google suite and lets claude do its thing.

605

Mcp Knowledge Graph

shaneholloman

MCP server enabling persistent memory for Claude through a local knowledge graph - fork focused on local development

871

Context Portal MCP (ConPort)

GreatScottyMac

Context Portal (ConPort): A memory bank MCP server building a project-specific knowledge graph to supercharge AI assistants. Enables powerful Retrieval Augmented Generation (RAG) for context-aware development in your IDE.

763

Memlord

MyrikLD

Memlord is a remote MCP server available at https://app.memlord.com.