looky-looky

Each .o-o.html file is a self-updating living document — open it in a browser to read, run it with bash to update.

open  article.o-o.html   # read it
bash  article.o-o.html   # update it

No build step, no server, no database. The file is the app.

Every .o-o.html is a polyglot — valid HTML and valid bash. The browser renders a formatted article with TOC, citations, and embedded images. Bash reads an embedded update contract, launches an LLM research agent, and the agent edits the article in-place with fresh information from the web.

# Update an existing document
bash example/anthropic-leadership.o-o.html

# Create a new living document
bash example/index.o-o.html --new "SpaceX Starship / Development progress and mission timeline"

# Update all stale documents
bash example/index.o-o.html --update-all

┌─────────────────────────────────────────┐
│  Shell preamble (hidden from browser    │  ← bash reads this
│  via : << 'OO_HTML' heredoc)            │
├─────────────────────────────────────────┤
│  HTML + CSS + Article content           │  ← browser renders this
│  Manifest, Contract, Binder JS          │
├── window.stop() ────────────────────────┤
│  Machine-readable zone                  │  ← agent reads this
│  (source cache, changelog)              │
├── OO_HTML ──────────────────────────────┤
│  Shell execution code                   │  ← bash runs this
│  (arg parsing, agent dispatch)          │
└─────────────────────────────────────────┘

When you run bash file.o-o.html:

1. The shell preamble hides the HTML via a heredoc
2. The shell code at the bottom parses flags and extracts the budget
3. It launches claude -p with a minimal prompt: read the file yourself
4. The agent reads the embedded contract, searches the web, and edits the article in-place

The agent never receives the whole file as prompt context — it reads the file itself and surgically modifies the <article>, manifest, source cache, and changelog.

Each document embeds a JSON contract that controls the agent:

{
  "identity": { "subject": "...", "scope": "...", "audience": "...", "tone": "..." },
  "research": { "intents": ["..."], "required_sections": ["..."], "source_policy": {...} },
  "budget":   { "max_cost_usd": 0.50 },
  "images":   { "allow": true, "max_per_article": 8, "resize_max_px": 800 }
}

The manifest tracks update frequency — "update_every_days": 7 means the file self-checks and won't spend money if it was updated less than 7 days ago. Use --force to override.

Click the version badge in any document's header to inspect its contract in-browser.

index.o-o.html serves as both a browsable card-grid library and a management CLI:

bash index.o-o.html                                    # Rebuild index
bash index.o-o.html --new "Topic / extended scope"     # Create new document
bash index.o-o.html --new                              # Create (interactive)
bash index.o-o.html --update-all                       # Update stale documents
bash index.o-o.html --update-all --force               # Force update all

bash document.o-o.html [OPTIONS]

  --agent NAME    Agent backend (default: claude)
  --model NAME    Override model (e.g. opus, sonnet, haiku)
  --force         Update even if not due yet
  --help, -h      Show help

• bash 3.2+ (ships with macOS) or any modern Linux bash
• Claude Code CLI (claude command)

No Python, Node, jq, or GNU coreutils. Portable across macOS and Linux.

• A self-updating competitive intel brief on your main rival
• A sentinel doc that watches for a regulatory ruling and alerts when it drops
• A living product comparison that re-benchmarks every month
• A due diligence file on a company you're evaluating
• A weekly team briefing that writes itself
• A personal wiki that keeps itself current

• cron + o-o — fully hands-off updates on a schedule (0 6 * * 1 bash ~/docs/*.o-o.html)
• GitHub Actions — auto-update docs in a repo, commit the diff, open a PR with the changelog
• Diff viewer — visual side-by-side showing exactly what changed between versions

Each update costs $0.50–$3.00 depending on scope and model. The budget is embedded in the contract — set it once, forget it.

MIT