agent-rsvp

agent-rsvp

A terminal RSVP (Rapid Serial Visual Presentation) speed reader. Words flash one at a time, pinned on their focal letter between two guide lines, with a live words-per-minute slider.

Install

Runs on Node ≥ 20.11 (Bun is only needed for development).

# one-off, no install
npx agent-rsvp sample.md
npx agent-rsvp -w 450 sample.md

# or install globally
npm i -g agent-rsvp
agent-rsvp sample.md

agent-rsvp                      # built-in sample text
agent-rsvp sample.md            # read a file (Markdown/docs flattened to prose)
agent-rsvp sample.md -w 450     # start at 450 wpm
cat tea.txt | agent-rsvp -w 250 # read piped stdin at 250 wpm

-w / --wpm sets the starting speed. Piped input stays fully interactive — the keyboard controls read from the controlling terminal (/dev/tty).

-o / --open opens the reader in its own new Terminal window instead of running inline (handy when launching from a context that doesn't own a tty):

agent-rsvp -o sample.md -w 350   # from a file
pbpaste | agent-rsvp -o -w 350   # from the clipboard / stdin

Modes

• minimal (default): just the single focal word between the guide lines.
• context: the full passage flows around the focal band, with the already-read text above and upcoming text below fading to black at the edges.

Press m (or tab) to switch.

Use inside Claude Code

This package also ships a Claude Code plugin with a /rsvp slash command. Once installed, run /rsvp to speed-read the plan Claude most recently presented (or a file/text you name) in a new Terminal window (the reader is a full-screen TUI, so it needs its own tty).

Under the hood /rsvp calls the CLI with --open:

npx -y agent-rsvp -o plan.md -w 350      # from a file
pbpaste | npx -y agent-rsvp -o -w 350    # from the clipboard / stdin

Controls

Key	Action
← / →	decrease / increase speed (25 wpm)
space	pause / resume
↑/↓ or l/h	scrub forward / back one word
m / tab	toggle context / minimal mode
?	hide / show the HUD (distraction-free)
r	restart from the beginning
q / Ctrl-C	quit

Development

bun install
bun run dev sample.md       # run from source
bun run build               # compile to dist/ (node-ready, with shebangs)

Built with Bun.