Retro

A collaborative sprint retrospective, run from the terminal but joined from any browser.

How it works

Retro mode is built around a live board rather than a solo report. The host opens the Retro page in the yeaboi TUI, which starts a small local web server for the session. Teammates then open a URL from any browser on the LAN — no install or account required — and add sticky cards to four grids: What went well, What didn't go well, Action items, and Demos.

Because the board is served over the network rather than shared as a static file, everyone sees the same state as it grows: cards added by any participant update live on every other participant's screen, kept in sync by polling the server every 2 seconds.

Access to a session is protected rather than open to anyone who happens to be on the network. Each retro gets a random access token together with a short, human-friendly join code, so the board can't be discovered or written to by an uninvited device. Card text itself is also treated as untrusted input — it's length-capped and escaped everywhere it gets rendered, so a pasted card can't be used to break the page.

Beyond the four grids, the live board supports emoji reactions on cards, drag-to-reorder, a shared countdown timer, a theme switcher, and ambient background music — all built with zero extra dependencies, since the server itself is just Python's standard-library HTTP server.

Joining

Teammates get into a running retro via the join code and URL the host shares, rather than needing any setup of their own. The short code is designed to be easy to read aloud or type in on the spot, and it resolves to the same token-gated board as the full URL, so there's no separate account step for anyone joining the session.

AI action items

Once the retrospective discussion winds down, yeaboi can turn the "didn't go well" cards into a set of suggested action items with a single LLM call. These AI-suggested items are clearly marked as AI-added on the board, so the team can tell at a glance which action items came from the discussion itself and which were synthesized afterward.

Remote sharing

The board is a LAN server by default, which covers a team in the same office or on the same network. For remote or hybrid teams, a "Share Remotely" button opens a free Cloudflare quick tunnel, making the board reachable from outside the LAN while remaining protected by the same token gate as local access.

Exports

Every retro auto-exports once it wraps up, saving both a Markdown file and a self-contained HTML report to ~/.yeaboi/exports/retro/<project>/, so the outcome of the session is captured as a shareable document rather than something that only lived on the board.