/how · PikoClaw

How PikoClaw methodology is published

PikoClaw’s public surface is MkDocs Material on GitHub Pages at nft2-me.github.io/PikoClaw/ — install, architecture, API, and ADRs for local email-archive extraction. The CLI run is local (air-gapped by the docs). The frontend at dev.pappas.work is a separate live app, not the private API.

Pipeline verified 2026-08-16

Pipeline

Public docs are static GitHub Pages. Extraction runs locally via the documented CLI — not hosted on this hub. Child routes like architecture/overview/ are live; bare architecture/ parent indexes 404.

Honest public surface: stranger → MkDocs Pages; local archive → CLI → outputs. App frontend is separate (verified 2026-08-16).

Allowed captures

Public MkDocs only — docs home hero and architecture/overview (where the live mermaid ships as a raw code block, not a rendered diagram). No app upload UI, no mail dumps.

Cropped PikoClaw MkDocs home: H1 PikoClaw, envelope-to-brain mark, and tagline Extract institutional knowledge from email archives. — Public docs home only (nft2-me.github.io/PikoClaw/) — not the private repo and not the app at dev.pappas.work.

Cropped PikoClaw architecture overview page showing System Architecture Diagram with Mermaid source as a raw code block. — Live child path architecture/overview/ (200). Bare architecture/ is 404. On the live page the mermaid is a raw fenced code block, not a rendered diagram.

Host and cache

Host: GitHub Pages — MkDocs Material site at nft2-me.github.io/PikoClaw/.
Real public nav includes Installation, Architecture, API, ADRs; some parent indexes 404 while child pages return 200 (e.g. architecture/overview/).
CLI (pikoclaw extract) is documented as local / air-gapped — not a hub-hosted Worker.
dev.pappas.work is a separate live frontend (app, not the private API). No private Workers URL on this HOW.

What is live vs static

Source	Live or static	Card
GitHub Pages MkDocs (nft2-me.github.io/PikoClaw/)	Static public docs	Methodology pages
pikoclaw extract (documented CLI)	Local run (not hosted on hub)	Extraction pipeline
dev.pappas.work	Separate live frontend	App (not private API)
Private Workers / private GitHub	Not linked	Out of scope for this HOW

Public links

PikoClaw methodology docs
Public MkDocs Material — primary door
Installation (child page)
Live child route under Getting Started
Architecture overview
Live child path — bare /architecture/ is 404
PikoClaw app frontend
Live frontend — app, not the private API

Not copied onto this hub page

No private GitHub (nft2-me/PikoClaw) — stranger 404; not listed in links[].
No mail dumps / PST contents.
No private API / Workers URL.
No NFT2.me marketplace.
No stolen X handle.
No Geryon / Skylight / Workwife.

Index: /how. Also listed on /sites and noted on /now.