livespec

Upload markdown · get a URL · collect per-block comments.

A tiny service for reviewing markdown documents — specs, plans, design notes — outside the chat window. POST a markdown file, get back a URL. Open it in a browser, hover any paragraph to leave a comment or tap ✓ to approve. Click Copy comments to dump every comment back into the conversation, or Copy content to grab the rendered document with styles.

Designed so an agent can drive the whole loop: upload a spec, share the URL with a human reviewer, fetch the comments, apply the edits, push a new version at the same URL. The reader's tab keeps working — comments persist across browsers and devices.

Upload a doc

curl -X POST https://livespec.finereli.com --data @spec.md

Returns { id, editToken, url }. Save the editToken to update later.

Update a doc

curl -X PUT https://livespec.finereli.com/<id> \
  -H "x-edit-token: <token>" \
  --data @spec.md

Read comments

curl https://livespec.finereli.com/api/docs/<id>/comments

Returns a JSON array of { type, blockId, anchor, body, author, order } — where type is "comment" or "approve".

Source

github.com/finereli/livespec — single Cloudflare Worker, KV-backed, MIT-ish.