Workshop
Vibe Coding: Personal Library App
- Saturday, November 7, 2026 11:00 am to 1:00 pm
- Thursday, November 26, 2026 6:00 pm to 8:00 pm
Build your own reading app, just by describing it.
For your AI agent (llms.txt)
If a person has asked you to join or do this workshop with them, read llms.txt. It says how to set it up. Ask them before you download, install or change anything.
A small app for your reading life: the books you have read and the books you want to read, all in one private place, with each title linked to the library catalogue so placing a hold is one click away. Your reading list stays on your own computer. The library keeps the books; this file keeps your reading life, and it travels with you.
Nextbook: use it, or build your own
Nextbook is a small web app for your reading life. It keeps your shelf, shows a card for each way of choosing what to read next, and sends you to the library’s own page for each book. A way of choosing is called a mode. A mode is one small file: it picks up to six books and gives a reason for each. In the workshop you describe a mode of your own, and an AI agent builds it with you.
- Use it: nextbook.ryankelln.com
- Source code: github.com/RKelln/nextbook (MIT licence)
Just use it
Open nextbook.ryankelln.com. There is nothing to install and no account. Your shelf stays in that browser on that computer.
Browsers can lose a shelf (clearing site data does it). On the shelf screen, press Download the shelf file under Save a copy now and then. Choose a shelf file under Import a shelf file brings it back, or moves it to another browser.
On the events screen you can press Get the latest events from all branches to see what is on across the city. It asks an events service, Togather, for the list and sends nothing about your books. If you add your own travel times, each event shows how long it takes to get there. Your agent can make that file for you.
Get a coding agent running
A coding agent is an app where an AI can work on files in a folder on your computer, with your permission. Get a coding agent running walks you through setting one up. OpenCode is the one it recommends, and it can use free models. If you already have a coding agent, you can skip that page.
Point your agent at this page
Open an empty folder in your agent, then paste this:
Read https://ryankelln.com/project/tpl_2026/w13-vibe-coding-library-app/nextbook-with-your-agent.md
and follow it. Ask me first whether I have my Nextbook folder from the workshop
or want to start fresh. Ask me before you download, install or change anything,
one question at a time, in plain words.
The guide tells your agent to check what you have, get Nextbook, run its checks, interview you about the mode you want, write a plan for you to approve, build it, and then have you test it in your browser. It does not need the workshop.
Carry on with your workshop copy
If you took the folder home on a USB stick, the folder is the project. Keep all of it.
- Open
dist/nextbook.htmlin Chrome or another browser. It is the whole app, with your mode inside it, and it needs no internet and no account. - Your shelf is not in the folder. It lives in the browser that opened the file, and a library computer clears itself when it restarts. At home, go to the shelf screen, press Use my own shelf, and add your own books. A page opened from a file and the hosted copy each keep their own shelf. Download the shelf file and Choose a shelf file move it between them.
- To keep building, open the whole folder in your coding agent and paste the sentence above, saying you have your folder. The notes for the agent are in
app/AGENTS.md.app/README.mdandapp/PLAN.mdhold what you wrote down in the session. - The loop is the same one: describe it, review the plan, build one thing, test it, fix it, write it down. Before a big change, copy
nextbook.htmltonextbook-old.htmlso you can go back.
Ideas and briefs to try
docs/modes/ has a brief for each way of choosing books: one book from every part of the library you never visit, a path from a book you loved to one you have been avoiding, books that argue with you, and more. Pick one and ask your agent to build it, or describe your own.
Be careful with what you share
- Your reading list is private. Keep your own shelf out of the agent’s hands unless you choose to share it. Test on the practice shelf, which is made up.
- An agent sees what is in its folder and what you type. Both go to the AI company behind it. The agent guide tells your agent to ask before reading your shelf and to give a notice first.
- Free models may keep what you send. Some free ones use it to improve the model. Read the model’s rule before you type anything personal.
- Read what the agent wants to do before you say yes. OpenCode does not ask unless you set it to, and the setup page shows how.
- Only point an agent at pages you trust. A page from a stranger can hold instructions meant to trick it. This site’s guide is the one this page names.
What you can take home
- The workshop, as a web page (read it, or do it at home with your AI agent)
- The workshop, as a PDF
- For your AI agent: where to start (llms.txt)
- Workshop kit: the library app, its tools and skills (zip, 355 KB)
- The finished survey mode from the workshop, to try (demo with a made-up shelf)
- Get a coding agent running (guide)
- Build your own mode with your agent (agent guide, text)
- Source files (GitHub)
- Nextbook, the app
Sessions
- Saturday, November 7, 2026 11:00 am to 1:00 pm Event page at the library
- Thursday, November 26, 2026 6:00 pm to 8:00 pm Event page at the library