Redlinez Cloud
A free hosted tier with limits, so you don't have to run the server yourself.
- Hosted dashboard and MCP endpoint
- Usage limits apply
- Not live yet
Open source / Visual feedback for AI agents
Press a hotkey, draw on anything on your screen, and write what should change. Claude, Codex or any MCP agent gets the picture, the exact spot and the context — then edits the code.
MIT licensed · macOS · Windows · Linux
Works with Claude Code Works with Codex CLI Works with Antigravity Works with any MCP agentOne hotkey freezes the screen under your cursor. Box, arrow, pen or pin — each mark gets its own note.
Annotated screenshot, a zoomed crop per mark and exact coordinates, served over MCP.
The agent reports back per mark. You click Looks good or send it back.
See it work
How it works
Press ⌥⇧M / Alt+Shift+M. Draw on a browser tab, a native app, a design file — anything. Write what should change, then ⌘↵ to save.
Requests are plain files in ~/.redlinez. Reopen one any time to move marks, edit comments or delete it.
Type /redlinez in Claude Code (or tell any agent “apply my latest Redlinez”). It reads the request over MCP, finds the matching code and makes the change.
Each mark comes back as review with a note. Click ✓ to mark it done, or ↺ to reopen it.
Web SDK / redlinez-react-js
Add one React component and your app gets its own feedback overlay. Click the floating button or press Alt+Shift+F, click an element or drag a box, write a comment and send. Works in Next.js and any React app.
EVERY MARK CAPTURES
// app/layout.tsx
import { Redlinez } from 'redlinez-react-js';
// inside <body>; user is optional
<Redlinez user={{ id: 'u1', name: 'Ada' }} />
// in your root component; settings are passed as props
import { Redlinez } from 'redlinez-react-js';
<Redlinez
mode="dev"
serverUrl="http://localhost:4480"
projectKey="your-project-key"
/>
# Next.js: .env.local
# off | dev | team | public (dev when NODE_ENV=development, else off)
NEXT_PUBLIC_REDLINEZ_MODE=dev
# default in dev: http://localhost:4480
NEXT_PUBLIC_REDLINEZ_SERVER_URL=http://localhost:4480
NEXT_PUBLIC_REDLINEZ_PROJECT_KEY=your-project-key
# from a clone of the repo (npm publish coming)
npm install ./SDK/redlinez-react-js
In development the overlay is on by default and sends marks to http://localhost:4480.
Start redlinez-server on your machine. It listens on http://localhost:4480 and shows a live dashboard at /.
<Redlinez />Drop the component into your layout or root component. Mark things in the running app and press send.
Point Claude Code, or any agent that speaks MCP over HTTP, at /mcp. It reads each mark and fixes it in your code.
redlinez-server / Open source
redlinez-server is a small Node server that receives the marks your app sends.
It stores them in SQLite, keeps screenshots as image files, shows everything in a live dashboard
and serves it to your agent over MCP at /mcp.
/, by default http://localhost:4480.~/.redlinez/server/redlinez.db, screenshots as image files.wait_for_edit_request long-polls, so an agent can fix marks as they arrive.# from a clone of the repo
cd redlinez-server && npm install && npm start
# or, once the package is on npm (publish coming)
# npx redlinez-server
# MCP over HTTP
claude mcp add --transport http redlinez-server \
http://localhost:4480/mcp
Any agent that supports MCP over HTTP can use the same /mcp URL.
list_edit_requestsLists the edit requests the server holds.get_edit_requestReturns one request with its marks and what each mark captured.update_edit_request_statusSets the status of a request after the agent worked on it.delete_edit_requestDeletes a request.wait_for_edit_requestLong-poll: waits until a new request arrives.devYou, on your own machine. The default when NODE_ENV=development.teamPeople you invite.publicAny visitor. A team member approves public marks in the dashboard before agents see them.offNobody: the overlay is disabled. The default outside development.Hosting
A free hosted tier with limits, so you don't have to run the server yourself.
A paid hosted plan is planned. Pricing has not been announced.
Run the open source redlinez-server on your machine or your own infrastructure.
Desktop app / Built-in MCP server
Redlinez speaks the Model Context Protocol, so it plugs into the agent you already use. Four tools, one prompt, zero cloud.
# add once, available in every project
claude mcp add --scope user redlinez -- \
node /path/to/redlinez/desktop-app/mcp/server.js
// Settings → Developer → Edit Config
{
"mcpServers": {
"redlinez": {
"command": "node",
"args": ["/path/to/redlinez/desktop-app/mcp/server.js"]
}
}
}
# or add [mcp_servers.redlinez] to ~/.codex/config.toml
codex mcp add redlinez -- \
node /path/to/redlinez/desktop-app/mcp/server.js
// Agent panel → MCP Servers → View raw config
{
"mcpServers": {
"redlinez": {
"command": "node",
"args": ["/path/to/redlinez/desktop-app/mcp/server.js"]
}
}
}
Cursor, Windsurf, VS Code, Cline and Zed use the same command / args entry.
list_edit_requestsLists requests, newest first, filtered by status.get_edit_requestAnnotated preview, a crop per open mark and a structured description.update_edit_request_statusSets status per mark with notes you see in the app.delete_edit_requestDeletes a request — only when you ask.apply_latestPrompt: implement every unfinished mark and report back.Download
Menu-bar app with its own Screen Recording permission. Captures app, window and URL context.
Download for MacLives in the system tray. No extra permission needed for screen capture.
Download for WindowsTray app for X11; on Wayland, capture goes through the desktop portal.
Download for Linuxv0.0.1-beta Pre-release builds, not yet signed: the first launch shows a security prompt. Release notes · All releases ↗
git clone https://github.com/sislamrafi/redline.git redlinez
cd redlinez/desktop-app && npm install
npm run app