O-O – polyglot HTML files that update themselves (bash/LLM)

I just wanted access to information that updated itself at some interval, without having to run my own server, deal with databases etc. Its also nice that I can share files with others and it mostly just "works" since its html. I also wanted to have a bit of fun.

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

Each .o-o.html file is a polyglot — valid HTML and valid bash. Open it in a browser to read a formatted article with TOC, citations, and images. Run it with bash to have an AI agent research the web and rewrite the article in-place with fresh information.

open article.o-o.html # read it

bash article.o-o.html # update it

Every document embeds an update contract — a JSON block that tells the agent what to research, which sections to maintain, what sources to trust, and how much to spend. The agent reads the contract, searches the web, and surgically edits only the <article> content, manifest, and source cache. The shell never sees the article text.

```

bash index.o-o.html --new <-- create your own article

bash your-article-title.o-o.html <-- populate / update the article

bash index.o-o.html --update-all <-- update and index all articles in the filder

```

The index file doubles as a library manager — it generates new documents from a template and batch-updates stale ones.

Requirements: bash 3.2+ and the Claude Code CLI. No Python, Node, or jq.

https://github.com/jahala/o-o