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
600files
2,276imports
7languages
13,210symbols

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

22047 lines~1170662 tokens
Open raw markdown

MiniOS

README.md

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

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

613 lines~15069 tokens
Open raw markdown

API

readmenator-agent/API.md

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

9596 lines~252965 tokens
Open raw markdown

Architecture

readmenator-agent/ARCHITECTURE.md

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

1743 lines~24243 tokens
Open raw markdown

Concepts

readmenator-agent/CONCEPTS.md

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

120 lines~4770 tokens
Open raw markdown

Gotchas

readmenator-agent/GOTCHAS.md

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

69 lines~998 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.

2554 lines~43295 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.