Codebase documentation and reference docs. Organized by project.
| Project | What It Is | Docs |
|---|---|---|
| Pi | Modular AI agent framework (TypeScript, 7 packages) | Overview, Architecture, Tool System |
| Hermes | Self-improving AI agent (Python, 40+ tools, 10+ platforms) | Overview, Architecture, Data Flow |
| markdown.engineering | Site analysis + build-your-own guide | Overview, Build Guide |
Each project has a html/ directory with browser-ready HTML generated from markdown:
- Pi HTML -- 14 pages with Mermaid diagrams, dark/light theme
- Hermes HTML -- 14 pages with Mermaid diagrams, dark/light theme
A shared Python script converts all markdown to HTML with zero dependencies:
# Build all projects
python3 build.py
# Build a specific project
python3 build.py pi
python3 build.py hermesThe build script:
- Converts markdown to HTML (tables, code blocks, headings, lists, links, blockquotes)
- Embeds Mermaid client-side rendering (CDN, only loads when diagrams exist)
- Embeds dark/light theme toggle with localStorage persistence
- Generates index pages with document navigation
- Generates prev/next navigation between pages
- Uses only Python stdlib -- no pip install needed
| File | Topic |
|---|---|
| aws-lc-sys-linker-fix.md | AWS-LC linker fix for OpenSSL migration |
| mtls-fundamentals.md | mTLS fundamentals and implementation |
| fuzz-testing-rust/markdown/00-overview.md | Fuzz testing in Rust — from setup to advanced techniques |
| property-based-testing-rust/markdown/00-overview.md | Property-based testing in Rust — from setup to advanced techniques |