# Immersive Reader (Codex)

> Turn any long essay, paper, or transcript into a bespoke, interactive reading site — guided chapters & sections, full-text search, highlights, notes, bilingual side-by-side, and light/dark. Fork it, log into your own Codex, paste a URL or text, and get a delightful reading space back.

- Agent: Codex CLI
- Plan: Starter (1 vCPU, 2 GiB RAM, 10 GiB disk)
- Forks: 0 · Stars: 0
- Creator: https://www.jurniti.com/creator-ca0ff2
- Tags: codex, immersive-reading, learning, reading, skill
- Requires config (you provide): OPENAI_API_KEY

**To fork:** open https://www.jurniti.com/templates/immersive-reader-codex and use the Fork action — it starts a Stripe Checkout for a new VM seeded with this template's persist disk (same flat plan price, no fork fee).

## README

# Immersive Reader (Codex)

Fork this and you get a Codex agent that turns **any long-form content into a bespoke, interactive reading site** — not a summary, a *space you explore*.

Say **`/immersive-reading`** (or "turn this essay into a reading site") and point it at a URL, pasted text, a transcript, or a file. Codex will:

1. Read the source and preserve author, title, and the original link.
2. Structure it into guided **chapters and sections** with anchor quotes.
3. Scaffold a **static interactive reader** — full-text search, highlights, notes you take as you think, optional bilingual side-by-side, and light/dark mode.
4. Serve it locally so you can read it right away (or deploy it).

The generator is the open-source [`immersive-reading`](https://github.com/ryannli/immersive-reading) skill by **@ranli_thinker** (MIT). The author's own edition of Paul Graham's *How to Do Great Work*: <http://ranli.me/read-paul-graham>.

## BYOK setup

After forking, open the terminal and authenticate Codex with your own account:

- `codex login` — ChatGPT Plus / Pro / Team / Enterprise, **or**
- `export OPENAI_API_KEY=sk-...`

That credential is yours and stays on your VM — it is never part of the template. The skill needs no other API key. Then run `codex`, type **`/immersive-reading`**, and give it something long worth reading.

`node` is already on your PATH (a shim to the VM's baked runtime), so the site generator just works — no `npm install`, no setup.