Zero-token knowledge base

ReadMenator | System Maps

Architecture maps, an overview video, and the full documentation set, generated offline from the source code. Nothing here was written by an LLM.

7communities
161files
1,391imports
3languages
3,175symbols

Interactive maps

Physics-driven diagrams: drag nodes, click one for its documentation, trace upstream or downstream reach. Maps load their engine from a CDN.

Overview video

Cinematic synthwave overview rendered from real scan data: layers, god nodes, dependency tree, communities, import graph, and code DNA. Open/download readmenator.mp4.

Documentation 43 files

Wiki 12

Concept pages per code community: start with index.md.

Second Brain

readmenator-wiki/index.md

The codebase centres on config.py, models.py, app.py. Architecturally it is 6 layers, dominant utility (88 files) across 8 import-based communities. Recorded...

79 lines~812 tokens
Open raw markdown

readmenator: _video

readmenator-wiki/community_0_readmenator_video.md

Community 0 | 41 files | cohesion 0.35

129 lines~1945 tokens
Open raw markdown

readmenator/parsers

readmenator-wiki/community_1_readmenator_parsers.md

Community 1 | 34 files | cohesion 0.52

130 lines~2153 tokens
Open raw markdown

readmenator: _agent_output

readmenator-wiki/community_2_readmenator_agent_output.md

Community 2 | 19 files | cohesion 0.33

110 lines~2238 tokens
Open raw markdown

readmenator: _graphrag

readmenator-wiki/community_3_readmenator_graphrag.md

Community 3 | 18 files | cohesion 0.32

112 lines~1887 tokens
Open raw markdown

readmenator: _pipeline

readmenator-wiki/community_4_readmenator_pipeline.md

Community 4 | 18 files | cohesion 0.26

120 lines~2322 tokens
Open raw markdown

readmenator: _diagrams

readmenator-wiki/community_5_readmenator_diagrams.md

Community 5 | 15 files | cohesion 0.39

116 lines~2395 tokens
Open raw markdown

readmenator: _flowcharts

readmenator-wiki/community_6_readmenator_flowcharts.md

Community 6 | 12 files | cohesion 0.44

97 lines~1929 tokens
Open raw markdown

orphans

readmenator-wiki/community_7_orphans.md

Community 7 | 4 files | cohesion 0.00

75 lines~1521 tokens
Open raw markdown

Concepts

readmenator-wiki/concepts.md

Second-brain semantic layer: nouns map atomically to file sets (EXTRACTED); verbs aggregate structural edges (INFERRED).

124 lines~3230 tokens
Open raw markdown

Queries

readmenator-wiki/queries.md

Log each answered question here so the wiki compounds. Format: question, answer, cited files.

29 lines~177 tokens
Open raw markdown

Audit Report

readmenator-wiki/REPORT.md

Project: ReadMenator | 2026-10-30 | offline, deterministic

43 lines~363 tokens
Open raw markdown

GraphRAG 1

Community report hierarchy for agents. Query it with: readmenator . ask "question" (or MCP readmenator.graphrag).

GraphRAG Community Reports

readmenator-graphrag/REPORTS.md

Entities: 3432 | Relationships: 11867 | Communities: 8 | Themes: 2 | Text units: 3319

158 lines~4418 tokens
Open raw markdown

Project docs 12

Knowledge base, README, and policies.

Polyglot Codebase Knowledge Graph

KNOWLEDGE_BASE.md

Start here: Statistics Dashboard for scope, God Nodes for blast radius, Architecture Reference for per-file API. Agents: prefer readmenator-agent/INDEX.md +...

11659 lines~464817 tokens
Open raw markdown

ReadMenator

README.md

A token-free, offline, production-grade polyglot codebase knowledge graph & architectural analyzer.

559 lines~8099 tokens
Open raw markdown

overview.md

readmenator-diagrams/overview.md

Static architecture map of 161 files (js, py, sh) in 7 components: readmenator: video, readmenator/parsers, readmenator: agentoutput, readmenator: graphrag...

166 lines~2755 tokens
Open raw markdown

readmenator: _agent_output

readmenator-diagrams/readmenator__agent_output.md

readmenator: agentoutput groups 19 files (py) around ImportResolver, init, buildstemindex, builddirindex, resolve. Agent-friendly output generator for...

40 lines~316 tokens
Open raw markdown

readmenator: _diagrams

readmenator-diagrams/readmenator__diagrams.md

readmenator: diagrams groups 15 files (py) around tomlstr, tomlvalue, templatetext, configpath, ensureprojectconfig. Edge bundle explorer: circle and sphere...

36 lines~301 tokens
Open raw markdown

readmenator: _flowcharts

readmenator-diagrams/readmenator__flowcharts.md

readmenator: flowcharts groups 12 files (py) around receivertext, SymbolDef, CallSite, ResolvedCall, kindtonodetype. Deterministic API reference model...

33 lines~291 tokens
Open raw markdown

readmenator: _graphrag

readmenator-diagrams/readmenator__graphrag.md

readmenator: graphrag groups 18 files (py) around EdgeKind, str, Morphism, weight, Category. ReadMenator -- Zero-token polyglot codebase knowledge graph...

39 lines~290 tokens
Open raw markdown

readmenator: _pipeline

readmenator-diagrams/readmenator__pipeline.md

readmenator: pipeline groups 18 files (py) around ReadmeInjector, init, inject, extractcurrentinjection, removeoldinjection. Injects KNOWLEDGEBASE.md...

39 lines~329 tokens
Open raw markdown

readmenator: _video

readmenator-diagrams/readmenator__video.md

readmenator: video groups 41 files (py) around Config, readmenatorApplication, init, ingestreceipts, scan. Launcher shim that runs the readmenator CLI from a...

68 lines~514 tokens
Open raw markdown

readmenator/parsers

readmenator-diagrams/readmenator_parsers.md

readmenator/parsers groups 34 files (py) around Symbol, Node, Edge, SecurityFinding, pluralizesymbolkind. Hotspot, dependency cycle, and change impact analysis.

55 lines~442 tokens
Open raw markdown

Security Policy

SECURITY.md

Use this section to tell people about which versions of your project are

21 lines~154 tokens
Open raw markdown

/readmenator

SKILL.md

Turn any codebase into a queryable knowledge base using pure static analysis. No LLMs. No tokens. No cloud.

210 lines~2347 tokens
Open raw markdown

Agent docs 13

Grep-friendly indexes for AI agents (also useful for humans).

API

readmenator-agent/API.md

ensurepkg (function) deploy.sh:22 -- Install or update one package (best effort: works offline with current versions, on PEP 668 systems, and before the...

1010 lines~32571 tokens
Open raw markdown

Architecture

readmenator-agent/ARCHITECTURE.md

readmenator.py -> readmenator/main.py

740 lines~11441 tokens
Open raw markdown

Concepts

readmenator-agent/CONCEPTS.md

Nouns map atomically to file sets (EXTRACTED); verbs aggregate structural edges (INFERRED).

120 lines~5215 tokens
Open raw markdown

Gotchas

readmenator-agent/GOTCHAS.md

These files have the most connections. Changes here have high blast radius.

55 lines~891 tokens
Open raw markdown

Subsystem: misc

readmenator-agent/KB_misc.md

Doc: Version 1.52.0 force-graph - https://github.com/vasturiano/force-graph

42 lines~281 tokens
Open raw markdown

Subsystem: parsers

readmenator-agent/KB_parsers.md

Doc: Parser factory: maps file extensions to per-language LanguageParser classes.

216 lines~2878 tokens
Open raw markdown

Subsystem: readmenator

readmenator-agent/KB_readmenator.md

Doc: ReadMenator -- Zero-token polyglot codebase knowledge graph generator.

2157 lines~38447 tokens
Open raw markdown

Subsystem: root

readmenator-agent/KB_root.md

Doc: one-liner deploy via deploynator (generic per-repo script).

57 lines~829 tokens
Open raw markdown

Subsystem: tests

readmenator-agent/KB_tests.md

Doc: Contract tests for agent-facing output quality: budgets, purposes, freshness, noise.

1940 lines~41913 tokens
Open raw markdown

Project Memory

readmenator-agent/MEMORY.md

Generated from 161 files at commit 855c3acd34c8. Read this first, then readmenator-wiki/index.md, then readmenator . ask "<question>" for anything specific.

140 lines~2768 tokens
Open raw markdown

Security Findings

readmenator-agent/SECURITY.md

3 lines~10 tokens
Open raw markdown

Symbols

readmenator-agent/SYMBOLS.md

3223 lines~89713 tokens
Open raw markdown

Recipes 5

Step-by-step tasks grounded in this codebase.

Recipe: Add a Function

readmenator-agent/recipes/add-function.md

Find the target file by purpose: grep -in '<topic>' readmenator-agent/INDEX.md

9 lines~99 tokens
Open raw markdown

Recipe: Change a File Safely

readmenator-agent/recipes/change-impact.md

Riskiest file: readmenator/category.py (105 dependents)

9 lines~109 tokens
Open raw markdown

Recipe: Fix a Dependency Cycle

readmenator-agent/recipes/fix-cycle.md

Read cycles: grep -A5 'Dependency Cycles' readmenator-agent/GOTCHAS.md

6 lines~65 tokens
Open raw markdown

Recipe: Fix a Security Finding

readmenator-agent/recipes/fix-security.md

Read findings: grep -n '<file>' readmenator-agent/SECURITY.md

6 lines~69 tokens
Open raw markdown

Recipe: Reduce File Complexity

readmenator-agent/recipes/reduce-complexity.md

Target hotspot: readmenator/vendor/force-graph.min.js

9 lines~86 tokens
Open raw markdown

How to read these maps

Open any map, then: drag nodes freely while physics settles the rest, search (/) to filter, click a node to focus it with full file documentation, Upstream and Downstream to trace authored reach, Path to probe the exact route between two ids, Lens to compare semantic roles, Play to walk the guided chapters, Stabilize to re-run physics, Theme for dark and light, Export for PNG or typed JSON. Deep links such as #route=a~b restore any reading.