# Tweak · Full Reference

> Client feedback on the live page. Embed-first website review with DOM pins, live style diffs, hosted hub, and MCP.

Product version: 0.13.29 · https://tweak.page

## What is Tweak?

Tweak is proprietary SaaS for structured review on real web pages. One Review ID ties staging (embed), the Chrome extension (developers, Chrome Web Store), the hosted hub, and optional MCP. Clients click elements on the live DOM — they do not chase screenshots, Looms, or “which page?” email threads.

Built for studios, freelancers, agencies, QA, and product teams reviewing staging sites with clients.

## Plans (active reviews)

Limits are concurrent **active reviews**, not “reviews per month.”

| | Free | Pro |
|---|---|---|
| Price | $0 forever | $39/mo · $390/yr (−17%) |
| Active reviews | 1 | 10 |
| Team seats | 3 | 10 |
| Artifact storage | 100 MB | 1 GB |
| AI agent tokens / review | 5 | 20 |
| Embed, extension, hub, share links, MCP, BYOK AI | ✓ | ✓ |
| Screenshot captures, workflow (priority/deadlines), activity, context snapshots | ✓ | ✓ |
| GitHub sign-in for developers | ✓ | ✓ |
| Feedback-request count, per-client retainer limit & over-count (monthly / weekly / quarterly period) | ✓ | ✓ |
| Clients retainer dashboard (all reviews rolled up), CSV export, public client usage link, MCP client-usage tools | — | ✓ |
| Priority support | — | ✓ |

Clients never pay. Details: https://tweak.page/upgrade · Billing: support@tweak.page

## Core features

### Embed-first live review
Paste `embed.js` with a Review ID on staging. Clients open the page and leave feedback without installing anything. Same ID in the hub and MCP.

### DOM-pinned comments + screenshots
Pins attach to real elements. A screenshot of that moment attaches automatically so context does not go stale.

### Live style editor
Clients change styles on the live page. The issue stores exact before/after values (e.g. background #1A1A1A → #7C3AED) — no “make it purple” reinterpretation.

### Drawing tools
Freehand, shapes, arrows, and lines with customizable stroke color/width on a floating toolbar.

### Threaded comments
Pin comments and reply in thread on the page instead of Slack/email digressions.

### Workflow & hub
Priority, deadlines, assignees, activity history, context snapshots. Triage and resolve in the hosted hub or extension overlay.

### Inspector
Point at an element → CSS selector, computed dimensions, AI-ready markdown for coding agents.

### Multi-inspect
Select multiple elements in one pass for bulk agent handoff.

### Measure / Area / Quick Grab
Pixel distances, rectangular region notes, Alt-held temporary element capture.

### Persistence
Reviews save over HTTPS. Source of truth is `review_pages.ops_json` (DrawOp array). Issues are derived — not a parallel issue table. Reopen the share link for the latest snapshot.

### Teams
GitHub-backed developer accounts; invite seats to a shared workspace (Free 3 / Pro 10).

### BYOK AI
Bring-your-own-key smart feedback runs in the browser; the API key stays in local storage and is not sent to Tweak servers.

### Works on any website
Overlay injects on production, staging, internal tools, and third-party pages (browser security and CSP permitting).

### Proprietary hosted product
Operated at tweak.page. Not open source. Not self-hostable. Contact legal@tweak.page for enterprise licensing.

## AI coding agents (MCP)

Hosted MCP: https://tweak.page/mcp (HTTP transport + GitHub OAuth). Tools cover list/search/acknowledge/assign/reply/resolve/dismiss. Changes use the same HTTPS API as the web app. No cookies or tokens in mcp.json.

Claude Code:

    claude mcp add tweak --transport http https://tweak.page/mcp -s user

Cursor / VS Code:

    { "mcpServers": { "tweak": { "url": "https://tweak.page/mcp" } } }

Paste https://tweak.page/s/REVIEW_ID in agent chat. Prefer `tweak_list_issues`, `tweak_switch_review`, `tweak_resolve_issue` over deprecated annotation aliases.

Setup: https://tweak.page/docs/mcp-setup

## Technical architecture

- **UI:** Preact + Preact Signals, Tailwind
- **Extension:** WXT (Chrome MV3)
- **API / hub:** Cloudflare Workers (Hono)
- **DB:** Cloudflare D1 (SQLite) — reviews, sessions, teams
- **Storage:** Cloudflare R2 (OG images, artifacts)
- **Agent bridge:** hosted MCP at /mcp
- **Build:** Bun workspaces, Turborepo, Vite
- **Version:** 0.13.29

## How it works

1. Sign in at tweak.page with GitHub (developers). Chrome extension: https://chromewebstore.google.com/detail/tweak/bdeghoehegkdnoigjlcjpiccgkimilfp
2. Create a review; paste embed on staging (or open the page under review in the extension)
3. Clients pin, style, draw, or comment on the live page
4. Team triages in hub / Chrome; optional MCP includes element + style context
5. Resolve, assign, or reply; review autosaves — reopen the link for the latest snapshot

## FAQ

Q: Do clients need the extension?
A: No. Embed or share link only. Extension is for the developer team (Chrome Web Store).

Q: What does it cost?
A: Free $0 (1 active review, 3 seats). Pro $39/mo or $390/yr. https://tweak.page/upgrade

Q: Open source?
A: No. Contact legal@tweak.page.

Q: Any website?
A: Yes — overlay on any page the browser can load (subject to CSP).

Q: Real-time multiplayer?
A: Reviews autosave over HTTPS; teams typically work async via hub/MCP and reload for the latest snapshot.

Q: Browsers?
A: Chrome and Chromium-based (Edge, Brave, Arc, etc.).

Q: Data retention?
A: Idle reviews may be removed after 90 days by default. Owner delete is immediate. https://tweak.page/docs/data-retention

## Links

- https://tweak.page
- https://tweak.page/upgrade
- https://tweak.page/docs/quick-start
- https://tweak.page/docs/mcp-setup
- https://tweak.page/docs/install-extension
- https://tweak.page/privacy
- https://tweak.page/support
- support@tweak.page · legal@tweak.page · security@tweak.page

## Contact

Email: support@tweak.page