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
155files
1,332imports
3languages
3,029symbols

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 models.py, config.py, pipeline.py. Architecturally it is 6 layers, dominant utility (84 files) across 8 import-based communities....

79 lines~813 tokens
Open raw markdown

readmenator: _video

readmenator-wiki/community_0_readmenator_video.md

Community 0 | 35 files | cohesion 0.30

129 lines~1919 tokens
Open raw markdown

readmenator/parsers

readmenator-wiki/community_1_readmenator_parsers.md

Community 1 | 35 files | cohesion 0.52

130 lines~2134 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

111 lines~1862 tokens
Open raw markdown

readmenator: _pipeline

readmenator-wiki/community_4_readmenator_pipeline.md

Community 4 | 17 files | cohesion 0.26

118 lines~2302 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

98 lines~1955 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~3228 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~178 tokens
Open raw markdown

Audit Report

readmenator-wiki/REPORT.md

Project: ReadMenator | 2026-10-14 | 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: 3277 | Relationships: 11336 | Communities: 8 | Themes: 2 | Text units: 3164

158 lines~4404 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 +...

11284 lines~448142 tokens
Open raw markdown

ReadMenator

README.md

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

546 lines~7960 tokens
Open raw markdown

overview.md

readmenator-diagrams/overview.md

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

167 lines~2772 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 17 files (py) around ReadmeInjector, init, inject, extractcurrentinjection, removeoldinjection. Injects KNOWLEDGEBASE.md...

38 lines~323 tokens
Open raw markdown

readmenator: _video

readmenator-diagrams/readmenator__video.md

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

62 lines~477 tokens
Open raw markdown

readmenator/parsers

readmenator-diagrams/readmenator_parsers.md

readmenator/parsers groups 35 files (py) around Symbol, Node, Edge, SecurityFinding, pluralizesymbolkind. Mermaid graph renderer with intelligent pruning.

56 lines~440 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...

957 lines~31282 tokens
Open raw markdown

Architecture

readmenator-agent/ARCHITECTURE.md

readmenator.py -> readmenator/main.py

719 lines~11082 tokens
Open raw markdown

Concepts

readmenator-agent/CONCEPTS.md

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

120 lines~5212 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.

2043 lines~36606 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.

1863 lines~40207 tokens
Open raw markdown

Project Memory

readmenator-agent/MEMORY.md

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

136 lines~2420 tokens
Open raw markdown

Security Findings

readmenator-agent/SECURITY.md

3 lines~10 tokens
Open raw markdown

Symbols

readmenator-agent/SYMBOLS.md

3077 lines~85710 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.