Loupe
Loupe is a document- and live-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 live-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.
- Live 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:
docker run --rm -p 127.0.0.1:8080:80 ghcr.io/loupe-ac/loupe:demo
Open http://localhost:8080 and log in with [email protected] /
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 # start nginx, php-fpm, postgres
just composer install # runs inside the php-fpm container
just migrate-run # set up the database
just exec bin/console app:dev:seed # log in as [email protected] / password
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
loupe.ac/docs. 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, live review, admin
- Extending Loupe — proxy, Mercure, object
storage, social login, billing
- Operating — first run, recovery, backups
- Environment variables and
console commands
- Troubleshooting and
Known gaps
Contributing
See CONTRIBUTING and
Development. Please report security issues
privately — see SECURITY.
License
Copyright (C) 2026 Geoffrey Bachelet.
Licensed under the GNU Affero General Public License v3.0 or later
(AGPL-3.0-or-later). If you run a modified version of Loupe as a network service,
the AGPL requires you to make your source available to its users.
Every page carries a "Source code" link in the footer to satisfy that. It points
wherever APP_SOURCE_URL says, defaulting to this repository — correct for an
unmodified instance, and wrong for a modified one. If you change the code, set
APP_SOURCE_URL to the repository that holds your version.
