Zero-token knowledge base

miniOS | 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.

10communities
589files
2,248imports
7languages
13,027symbols

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 19 files

Project docs 3

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 +...

21751 lines~1145318 tokens
Open raw markdown

MiniOS

README.md

![GitHub stars](https://github.com/grisuno/miniOS)

182 lines~2966 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

Agent docs 16

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

Index

readmenator-agent/INDEX.md

602 lines~14775 tokens
Open raw markdown

API

readmenator-agent/API.md

Depends on: headers/arch/x86/boot/bootdefs.h

9464 lines~247258 tokens
Open raw markdown

Architecture

readmenator-agent/ARCHITECTURE.md

arch/x86/apentry.S -> headers/arch/x86/boot/bootdefs.h

1725 lines~24037 tokens
Open raw markdown

Concepts

readmenator-agent/CONCEPTS.md

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

120 lines~4783 tokens
Open raw markdown

Gotchas

readmenator-agent/GOTCHAS.md

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

69 lines~1001 tokens
Open raw markdown

Subsystem: asm

readmenator-agent/KB_asm.md

aesrk (function, line 3)

394 lines~3225 tokens
Open raw markdown

Subsystem: boot

readmenator-agent/KB_boot.md

Doc: MiniOS boot sector.

66 lines~563 tokens
Open raw markdown

Subsystem: doomgeneric

readmenator-agent/KB_doomgeneric.md

Doc: Copyright(C) 1993-1996 Id Software, Inc.

5404 lines~80742 tokens
Open raw markdown

Subsystem: drivers

readmenator-agent/KB_drivers.md

Doc: Block device layer for MiniFS.

802 lines~13611 tokens
Open raw markdown

Subsystem: file

readmenator-agent/KB_file.md

Doc: Docstring: MiniOS file browser (Nuklear ring-3 app, MiniFS: file/file.elf).

100 lines~1746 tokens
Open raw markdown

Subsystem: freedomui

readmenator-agent/KB_freedomui.md

Doc: freedomuiminios - Real FreeDom browser on MiniOS, DOOM/Q2G pattern.

223 lines~3637 tokens
Open raw markdown

Subsystem: fs

readmenator-agent/KB_fs.md

Doc: extgeot: Filesystem geometry from the superblock.

379 lines~6806 tokens
Open raw markdown

Subsystem: headers

readmenator-agent/KB_headers.md

Doc: Docstring: abi.h -- Boot-time ABI manifest gate contract.

2434 lines~41236 tokens
Open raw markdown

Subsystem: headers_arch_x86

readmenator-agent/KB_headers_arch_x86.md

Doc: per-CPU control-register setup shared by the BSP (kmain)

106 lines~1839 tokens
Open raw markdown

Subsystem: headers_drivers

readmenator-agent/KB_headers_drivers.md

Doc: Keyboard layout: US qwerty (default) or Spanish (Spain) qwerty.

301 lines~4875 tokens
Open raw markdown

Subsystem: headers_kernel

readmenator-agent/KB_headers_kernel.md

Doc: Docstring: consolein.h -- boundary of the console input device

36 lines~521 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.