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
579files
2,197imports
7languages
12,812symbols

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

21406 lines~1123101 tokens
Open raw markdown

MiniOS

README.md

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

2521 lines~33925 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

592 lines~14516 tokens
Open raw markdown

API

readmenator-agent/API.md

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

9333 lines~243194 tokens
Open raw markdown

Architecture

readmenator-agent/ARCHITECTURE.md

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

1707 lines~23762 tokens
Open raw markdown

Concepts

readmenator-agent/CONCEPTS.md

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

120 lines~4780 tokens
Open raw markdown

Gotchas

readmenator-agent/GOTCHAS.md

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

69 lines~1003 tokens
Open raw markdown

Subsystem: asm

readmenator-agent/KB_asm.md

aesrk (function, line 3)

385 lines~3177 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.

221 lines~3587 tokens
Open raw markdown

Subsystem: fs

readmenator-agent/KB_fs.md

Doc: extgeot: Filesystem geometry from the superblock.

377 lines~6762 tokens
Open raw markdown

Subsystem: headers

readmenator-agent/KB_headers.md

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

2405 lines~40671 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

35 lines~500 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.