ReviseMy

Mark feedback for your agent.

ReviseMy is an open-source human-in-the-loop design review tool. Your agent uploads UI screenshots over Laravel MCP, you open a review link, mark what matters like a design critique, then approve or request changes. The agent reads structured work packets and keeps going.

Built with Laravel, Livewire, Flux, Sanctum, and Laravel MCP — ready for Laravel Cloud.

Features

• Marks, not pins — product UI speaks in marks (rose rectangles + M1/M2 badges). Human marks are authoritative; API keys stay pins for compatibility.
• Rectangle-first review — drag to outline a region or click for a point note; zoom with +/− and pan with Space+drag (or middle mouse).
• Second opinion (hints only) — Cloud-queued design checklist on every screenshot; optional OpenAI vision when keyed. Sky S-markers never override your marks.
• Agent subagent path — add_findings drops suggestion / a11y / polish notes into the same review before you look.
• Work packets + next_action — agents know whether to wait, apply marks, open the next pass, or stop.
• Multi-pass checkups — create_review with parent_id for pass 2+ after you request changes.
• Try token, no account — one-click token on the homepage; paste MCP config for Cursor, Claude Code, VS Code, or ChatGPT.
• Secret review links — humans open /r/{token} without signing up.

Try it on any project (~2 minutes)

1. Open the hosted app (your *.laravel.cloud URL after deploy).
2. Click Get a try token.
3. Copy the MCP config for your client (Cursor, Claude, VS Code, or ChatGPT).
4. Ask your agent to screenshot UI work and call create_review.
5. Open the review link, mark feedback, approve or request changes.
6. Ask the agent to call get_review and follow next_action.

No account required for the human reviewer.

MCP tools

Tool	Purpose
create_review	title + screenshots (+ optional page_url, parent_id for next pass) → review URL; queues second opinion
get_review	work packets + next_action (wait_for_human / apply_pins_then_next_pass / done)
list_reviews	recent reviews for this try token
add_screenshot	append a shot to an open review
add_findings	agent subagent — push suggestion/a11y/polish into the review
request_second_opinion	re-queue Cloud checklist (+ vision if keyed)

Prompt: design_checkup_loop — full agent↔human checkup cycle.

Screenshots accept https URLs, data URLs, or base64.

Terminology: UI copy uses marks; JSON still uses work_packets.pins, related_pin, and apply_pins_then_next_pass. Second opinion is suggestions only — see docs/SECOND-OPINION.md.

MCP config (Cursor example)

After you get a try token from the homepage:

{
  "mcpServers": {
    "revisemy": {
      "url": "https://YOUR-APP.laravel.cloud/mcp/revisemy",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN"
      }
    }
  }
}

The homepage also copies configs for Claude Code, VS Code (servers key), and ChatGPT. Same URL + Bearer header works for any MCP host — see docs/CONNECTORS.md.

REST API (same auth)

• POST /api/try-token — create a try workspace + token
• POST /api/reviews — { "title", "context?", "page_url?", "parent_id?", "images": [...] }
• GET /api/reviews/{id}
• GET /api/reviews
• POST /api/reviews/{id}/screenshots — { "image" }
• POST /api/reviews/{id}/findings — { "findings": [...] }
• POST /api/reviews/{id}/second-opinion — optional { "screenshot_index" }

Local development

composer install
cp .env.example .env
php artisan key:generate
touch database/database.sqlite
php artisan migrate
php artisan storage:link
npm install && npm run build
php artisan serve

Visit http://127.0.0.1:8000, get a try token, and create a review.

Deploy on Laravel Cloud

1. Push this repo to GitHub.
2. In Laravel Cloud: New application → import the repo.
3. Attach Postgres and object storage.
4. Set env:
   • APP_NAME=ReviseMy
   • FILESYSTEM_DISK / REVISEMY_DISK to the Cloud object storage disk
   • APP_URL to your https://….laravel.cloud URL
   • Queue worker enabled (QUEUE_CONNECTION)
   • Optional OPENAI_API_KEY for vision second opinion
5. Deploy. Run migrations from Cloud commands: php artisan migrate --force
6. Reply to the contest with your https://….laravel.cloud homepage URL.

Self-host

Point MCP at your own origin. Use S3-compatible storage for screenshots in production. Rate limits and 7-day review expiry are built in.

Stack

• Laravel 13
• Livewire 4 + Flux UI
• Laravel MCP (web endpoint)
• Laravel Sanctum try tokens
• Postgres / SQLite + object storage

Docs

• CONNECTORS.md — Cursor / Claude / VS Code / ChatGPT packaging
• SECOND-OPINION.md — second opinion, agent subagent findings, work packets
• DEPLOY.md — Laravel Cloud contest deploy

License

MIT