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.
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