eztweak

Point at your live app. Your agent fixes it.

eztweak turns any locally running dev server into an annotatable review surface for human ↔ agent iteration. The user marks up the real page — click an element, select some text, leave a comment — and the feedback flows to a local coding agent (Claude Code, Codex, anything that can run a CLI) as structured items that resolve to exact source locations. The agent edits the code, HMR updates the page in place, the user reviews the next round.

$ npx -y eztweak http://localhost:5173/pricing   # opens the review shell
$ npx -y eztweak poll http://localhost:5173/     # agent blocks here until you hit send

• Zero config. A local daemon reverse-proxies your dev server and injects the annotation overlay. No code changes, no build plugins required, works with any framework.
• Anchored feedback. Annotations carry a layered anchor: file:line (with the optional Vite plugin), React component chain, data-section, CSS selector, text, viewport. Agents stop guessing which part of the page you meant.
• Built for the loop. Batch annotations, send once; the agent's poll is a blocking CLI call that prints structured JSON — the same portable contract as an AXI. HMR keeps iterations in place; the review chrome lives outside the app frame, so it survives your agent's syntax errors.
• Local-first. Everything binds to 127.0.0.1. Nothing leaves your machine.

Install

Nothing to install — npx -y eztweak is enough. For agents, add the bundled skill:

npx skills add cychien/eztweak --skill eztweak

Optional, for exact file:line anchors in Vite + React projects:

// vite.config.ts
import { eztweakSource } from 'eztweak/vite'

export default defineConfig({
  plugins: [eztweakSource(), react()],
})

Dev-only (apply: 'serve') — it never touches production builds.

Status

Early. On the roadmap: diff-derived Keep/Undo, screenshots, layout-issue detection, ACP mode.

License

MIT