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 ChatGPT, Claude, or Cursor.

• Secret review links — humans open /r/{token} without signing up.

Related MCP server: ui-ticket-mcp

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 (ChatGPT, Claude, or Cursor).

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

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 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 — ChatGPT / Claude / Cursor packaging

• SECOND-OPINION.md — second opinion, agent subagent findings, work packets

• DEPLOY.md — Laravel Cloud contest deploy

License

MIT