Zero-token knowledge base

blacksandbeacon | 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
52files
401imports
4languages
1,075symbols

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

Wiki 12

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

Second Brain

readmenator-wiki/index.md

The codebase centres on cJSON.h, aes.h, cJSON.c. Architecturally it is 4 layers, dominant utility (39 files) across 8 import-based communities. Recorded risk...

79 lines~757 tokens
Open raw markdown

root

readmenator-wiki/community_0_root.md

Community 0 | 10 files | cohesion 0.61

105 lines~1825 tokens
Open raw markdown

include: cJSON

readmenator-wiki/community_1_include_cjson.md

Community 1 | 9 files | cohesion 0.57

98 lines~1583 tokens
Open raw markdown

bof/include

readmenator-wiki/community_2_bof_include.md

Community 2 | 7 files | cohesion 1.00

86 lines~1328 tokens
Open raw markdown

include: server

readmenator-wiki/community_3_include_server.md

Community 3 | 3 files | cohesion 1.00

73 lines~1310 tokens
Open raw markdown

include: aes

readmenator-wiki/community_4_include_aes.md

Community 4 | 3 files | cohesion 0.40

79 lines~1455 tokens
Open raw markdown

include: config

readmenator-wiki/community_5_include_config.md

Community 5 | 3 files | cohesion 0.67

77 lines~1589 tokens
Open raw markdown

include: aes_cfb

readmenator-wiki/community_6_include_aes_cfb.md

Community 6 | 2 files | cohesion 1.00

50 lines~640 tokens
Open raw markdown

orphans

readmenator-wiki/community_7_orphans.md

Community 7 | 15 files | cohesion 0.00

107 lines~1601 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~2390 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~165 tokens
Open raw markdown

Audit Report

readmenator-wiki/REPORT.md

Project: blacksandbeacon | 2026-10-16 | offline, deterministic

43 lines~362 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: 1237 | Relationships: 2231 | Communities: 8 | Themes: 5 | Text units: 1098

180 lines~4145 tokens
Open raw markdown

Project docs 6

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

3358 lines~111979 tokens
Open raw markdown

Black Sand Beacon

README.md

A Linux C2 beacon with a native in-memory ELF BOF loader, written in

288 lines~2772 tokens
Open raw markdown

include: cJSON

readmenator-diagrams/include_cJSON.md

include: cJSON groups 9 files (c, h) around BEACONCOMMONH, GNUSOURCE, BSBOUTPUTBUFFERDEFAULT, BSBOUTPUTTRUNCATIONMARKER, httpresponset.

37 lines~275 tokens
Open raw markdown

overview.md

readmenator-diagrams/overview.md

Static architecture map of 52 files (c, h, py, sh) in 7 components: root, include: cJSON, bof/include, include: server, include: aes, include: config, include...

123 lines~1535 tokens
Open raw markdown

root

readmenator-diagrams/root.md

root groups 10 files (c, h) around AESH, CBC, ECB, CTR, AES256. tiny-AES-c (https://github.com/kokke/tiny-AES-c)

31 lines~161 tokens
Open raw markdown

Security Policy

SECURITY.md

Black Sand Beacon is actively developed. Only the latest release receives security updates.

48 lines~538 tokens
Open raw markdown

Agent docs 18

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

API

readmenator-agent/API.md

getSBoxValue (function) aes.c:13 static uint8t getSBoxValue(uint8t num)

749 lines~21193 tokens
Open raw markdown

Architecture

readmenator-agent/ARCHITECTURE.md

beacons/v1/beacon.c -> include/beaconcommon.h

90 lines~1580 tokens
Open raw markdown

Concepts

readmenator-agent/CONCEPTS.md

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

120 lines~3895 tokens
Open raw markdown

Gotchas

readmenator-agent/GOTCHAS.md

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

57 lines~843 tokens
Open raw markdown

Subsystem: bof_include

readmenator-agent/KB_bof_include.md

Doc: datap: Argument parser.

67 lines~1034 tokens
Open raw markdown

Subsystem: cat

readmenator-agent/KB_cat.md

go (function, line 15) void go(char args, int alen)

26 lines~286 tokens
Open raw markdown

Subsystem: include

readmenator-agent/KB_include.md

Doc: tiny-AES-c (https://github.com/kokke/tiny-AES-c)

459 lines~9056 tokens
Open raw markdown

Subsystem: is_sudo

readmenator-agent/KB_is_sudo.md

useringroup (function, line 15) static int useringroup(const char group, const char username, char filebuf, long filesize)

32 lines~428 tokens
Open raw markdown

Subsystem: misc

readmenator-agent/KB_misc.md

meshmsgt (struct, line 40)

84 lines~1099 tokens
Open raw markdown

Subsystem: root

readmenator-agent/KB_root.md

Doc: tiny-AES-c (https://github.com/kokke/tiny-AES-c)

574 lines~10443 tokens
Open raw markdown

Subsystem: tests

readmenator-agent/KB_tests.md

main (function, line 22) int main(void)

119 lines~1517 tokens
Open raw markdown

Subsystem: userenum

readmenator-agent/KB_userenum.md

userinmemberlist (function, line 52) static int userinmemberlist(const char username, const char members)

28 lines~344 tokens
Open raw markdown

Subsystem: v1

readmenator-agent/KB_v1.md

reportresult (function, line 24) static void reportresult(const bsbconfigt cfg,

51 lines~774 tokens
Open raw markdown

Subsystem: whoami

readmenator-agent/KB_whoami.md

go (function, line 19) void go(char args, int alen)

28 lines~311 tokens
Open raw markdown

Project Memory

readmenator-agent/MEMORY.md

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

91 lines~1307 tokens
Open raw markdown

Security Findings

readmenator-agent/SECURITY.md

3 lines~10 tokens
Open raw markdown

Symbols

readmenator-agent/SYMBOLS.md

1095 lines~27455 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: include/config.h (7 dependents)

9 lines~107 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: beacon5.c

9 lines~72 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.