ubermuda/loupe

Loupe is a document- and site-review tool for humans working with AI agents.
**loupe.ac** — the hosted instance ·
**Documentation** — install, connect an
agent, operate it
An agent (or a person) submits a Markdown **document**; humans review it inline —
selecting text, leaving comments, and either approving it or requesting changes.
A **Model Context Protocol (MCP)** endpoint lets AI coding agents create documents
and hand back a review URL, so a long-form plan or spec gets considered human
feedback instead of scrolling past in a terminal. A companion **site-review**
widget brings the same select-and-comment
flow to live web pages.
Built with Symfony, Tailwind CSS and Symfony UX (Stimulus + Turbo).
Features
- **Document review** — submit Markdown, review it rendered, comment on selected
passages, approve or request changes, and revise across versions.
- **MCP endpoint** — an agent signs in through OAuth and calls
document_create / document_revise, receiving a shareable review URL.
- **Site review** — an embeddable widget for
leaving review comments on any web page, streamed back to the reviewer over
Mercure.
- **Command-line bridge** *(preview, unreleased)* — a Go binary
(cli/) that watches your board and runs a non-interactive
Claude Code worker for every card moved to next.
- **Scoped OAuth access** — separate MCP, agent and site-review scopes. An agent
signs in through your browser, and nobody copies a credential by hand.
Try it
One container holding the app, its worker and Postgres:
Open and log in with admin@example.com /
loupe-admin. Bind to 127.0.0.1 as above — that password is published on this
page.
The image is for **evaluating** Loupe, not running it: its APP_SECRET is a
committed constant, nothing terminates TLS, and mail is discarded. See
Demo for the volume and port options.
Develop on it
just up publishes no host port — it expects a reverse proxy on an external
Docker network named traefik, and fails rather than degrades without one.
examples/ holds a working proxy and a plain-HTTP alternative;
Reverse proxy explains the choice.
Documentation
The full documentation is published at
**ubermuda.github.io/loupe**. It is built
from docs/ in this repository, so the same pages are readable
here on GitHub:
- Getting started connects your coding agent
and takes you through a first review
- Installing Loupe gives five ways to run it,
and helps you choose one
- Using Loupe — documents, MCP, site review, admin
- Extending Loupe — proxy, Mercure, object
storage, social login, billing