Skip to content

Read-Only Hosted View of EA Repo

A beautiful, lightweight web view of this repo so Hal can read and browse his idea corpus without opening GitHub or talking to Claude. Read-only. Updates automatically as Claude and Hal edit files.

Approach: Cloudflare Pages + MkDocs Material

  • Cloudflare Pages hosts the site for free (including private repos), rebuilds on every push, 500 builds/month included
  • MkDocs Material renders the markdown beautifully - dark/light mode, full-text search, instant navigation, responsive design
  • YAML frontmatter is stripped cleanly (not shown as raw text)
  • Manifest serves as the homepage; domain folders become sidebar sections
  • Sensitive files excluded (CLAUDE.md, .claude/ commands, inbox/, handoffs/)

How It Works

Since the repo's markdown lives at the root (not in a docs/ folder), build.sh assembles a temporary docs/ directory before MkDocs runs:

  • manifest.md becomes the homepage (docs/index.md)
  • learnings.md and domains/ are copied into docs/
  • docs/ and site/ are gitignored - they're build artifacts only

Cloudflare Pages runs the build on every push to main.

Status

Live. Cloudflare Pages is connected and rebuilds on every push to main. Every commit triggers a rebuild automatically (typically 30-60 seconds).

Maintenance

Zero. Navigation auto-discovers from the folder structure. New idea files appear in the sidebar automatically. No config changes needed.

Connections

  • EA System Development - the hosted view is a read layer on top of the EA system, making Phase 1 (repo structure) immediately more accessible without waiting for later phases
EA Reasoning (bootstrap mode) - Categorised as ai-tooling because this is infrastructure for interacting with the EA repo/workflow, not a Gen H product idea or a venture. It improves how Hal consumes the output of the AI-assisted EA system. - Connected to EA System Development because the hosted view is literally a read interface for the same repo the EA system manages. - Promoted to actionable: build pipeline fixed and tested. The only remaining step is Hal connecting the repo in Cloudflare Pages.