rea
Reverse engineer anything with agents, from app behavior down to native binaries.
- 474k
- TypeScript
- MIT
- 38 min ago
Before/after screenshots, pixel diffs and a UX summary for UI changes in a PR — an Agent Skill for Claude Code, Codex, Cursor, Copilot and more.
Repo davidamunga/ui-diff, read from GitHub 1 h ago. davidamunga has not joined Take My Repo.
davidamunga/ui-diff is a public repo on GitHub by davidamunga. Before/after screenshots, pixel diffs and a UX summary for UI changes in a PR — an Agent Skill for Claude Code, Codex, Cursor, Copilot and more. It declares the MIT license on GitHub. It is written mainly in JavaScript, has 1 stars and last changed on 2026-11-19. Nobody has reviewed it on Take My Repo yet, which says nothing about its quality. Read from GitHub on 2026-11-22.
In the maintainer's words. Shown from GitHub; Take My Repo does not keep a copy.
Reviewers can read a CSS diff, but they can't see it. ui-diff runs your app at the PR's base and head, screenshots the pages the change touches, and posts a before/after comment with the exact style changes measured, so designers and reviewers see what actually changed.
It's an Agent Skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Goose, Windsurf, Amp and other compatible agents, and a GitHub Action for CI.
Math.random seeded, so the shots are reproducible.padding 8px 14px → 12px 20px, #2563eb → #7c3aed, layout shifts, copy changes and new WCAG contrast failures.ui-diff/design-review check stays pending until someone with write access ticks "Design approved" in the comment.It also works on Storybook stories, compares the result against a Figma frame you link, and writes a local review page with a before/after slider.
Pick the line for the tool you use. They all install the same skill.
| You use | Run |
|---|---|
| Claude Code | /plugin marketplace add davidamunga/ui-diff/plugin install ui-diff@ui-diff |
| Any other agent (Codex, Cursor, Copilot, Gemini CLI, OpenCode, …) | npx skills add davidamunga/ui-diff -g |
| Several agents, kept in sync with one clone | git clone https://github.com/davidamunga/ui-diff.git./ui-diff/install.sh |
| CI only, no agent | the GitHub Action: see Run in CI |
Then start a new agent session (skills are loaded when a session starts) and ask something like "show me the UI changes on this branch".
Requirements: macOS or Linux, bash, git, Node.js 18+, and the GitHub CLI
(gh, logged in) to post to PRs. Plain-HTML sites also need python3. The first run downloads
Playwright and Chromium (about 150 MB) into ~/.cache/ui-diff; your project's dependencies
aren't touched.
Run these inside Claude Code:
/plugin marketplace add davidamunga/ui-diff
/plugin install ui-diff@ui-diff
To update later: /plugin marketplace update ui-diff, then /plugin update ui-diff@ui-diff.
To remove: /plugin uninstall ui-diff@ui-diff.
The skills CLI (needs Node 22.20+) knows where each agent keeps its skills.
npx skills add davidamunga/ui-diff -g # for your user; asks which agents
npx skills add davidamunga/ui-diff -g -a codex -a cursor # name the agents
npx skills add davidamunga/ui-diff # this project only
To update, run the same add command again.
git clone https://github.com/davidamunga/ui-diff.git && cd ui-diff
./install.sh # link into every agent it finds
./install.sh --list # show agents, their skills folders, and what's installed
./install.sh --agents codex,cursor # only these agents
./install.sh --project ~/Work/my-app # one project only (my-app/.agents/skills/)
./install.sh --agents claude # Claude Code as a plain skill instead of the plugin
./install.sh --copy # copy instead of symlink
./install.sh --uninstall # remove what it installed
It symlinks by default, so git pull in the clone updates every agent at once. It never
touches an existing ui-diff folder it didn't create.
Copy or symlink skills/ui-diff/ into your agent's skills folder:
| Agent | For your user | For one project |
|---|---|---|
| Claude Code | ~/.claude/skills/ |
.claude/skills/ |
| Codex, Cline | ~/.agents/skills/ |
.agents/skills/ |
| Cursor | ~/.cursor/skills/ |
.agents/skills/ |
| Gemini CLI | ~/.gemini/skills/ |
.agents/skills/ |
| GitHub Copilot | ~/.copilot/skills/ |
.agents/skills/ |
| OpenCode | ~/.config/opencode/skills/ |
.agents/skills/ |
| Goose | ~/.config/goose/skills/ |
.goose/skills/ |
| Windsurf | ~/.codeium/windsurf/skills/ |
.windsurf/skills/ |
| Amp | ~/.config/agents/skills/ |
.agents/skills/ |
Ask your agent in plain words, on a branch with UI changes:
add before/after screenshots of my UI changes to the PR
did my tailwind config change break any pages? check desktop and mobile
ui diff for PR #482, put it in the description
show the Button changes in Storybook
does /pricing match the design? https://www.figma.com/design/AbC123/App?node-id=12-34
The agent works out which pages to check, runs the comparison (usually under a minute),
shows you the summary, and asks before posting anything to the PR. Results stay in
.ui-diff/report/, including index.html, a review page with a before/after slider,
side-by-side view and diff overlay.
FIGMA_TOKEN. See figma.md.storageState for a test account and point .ui-diff.json at it. See Configure.The same pipeline runs as a GitHub Action on every push to a PR, with no agent. Copy
examples/workflows/ui-diff.yml into .github/workflows/:
on:
pull_request:
types: [opened, synchronize, reopened]
permissions:
contents: write # push screenshots to the ui-diff-assets branch
pull-requests: write # add / update the PR comment
jobs:
ui-diff:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
with:
ref: ${{ github.event.pull_request.head.sha }}
fetch-depth: 0
- run: npm ci # your project's install step
- uses: davidamunga/ui-diff@v0
# with:
# routes: /,/pricing # optional: picked from the changed files otherwise
How it differs from running it through an agent:
routes input and none in .ui-diff.json, routes.cjs picks them from the changed files: changed pages, routes under changed layouts, pages importing changed components (through aliases and workspace packages), and home plus a few well-linked pages for global styles. The log says why each was picked. Dynamic routes need example values (routeParams in .ui-diff.json). A PR that changes no page-affecting files is skipped; one where no route can be found fails and says so. Set auto-routes: false to require routes.summary.pull_request_target: that runs the PR's code with a write token.To remove a PR's images when it closes, add
examples/workflows/ui-diff-cleanup.yml (it runs
the action with mode: prune).
Opt in with require-approval: true to make UI changes need a sign-off before merge. The
action then sets a ui-diff/design-review commit status on the PR head:
pending ("2 pages changed — needs design review"), linking to the comment, which gets a
- [ ] **Design approved** box.success.Someone with write, maintain or admin access approves by ticking the box (or adding the
design-approved label, set with approval-label). That needs a second workflow,
examples/workflows/ui-diff-approve.yml, which
runs the action with mode: approve. It sets the status to success ("Approved by @them")
and adds "✅ Approved by @them for abc1234" under the box. Unticking or removing the label
puts it back to pending. Ticks from users without write access, and edits by the bot itself,
are ignored.
Approval belongs to one commit. The comment records the sha it was rendered for, and a
tick only counts while that sha is still the PR head. A new push with visual changes sets
the new commit to pending, renders an unticked box and removes the label. A re-run on an
already-approved commit keeps the approval.
To block merging until then, add ui-diff/design-review as a required status check in the
branch protection rule (or ruleset) for your default branch. It shows up in the list once
it's been reported on a PR. Add statuses: write to ui-diff.yml's permissions; the
approve workflow needs statuses: write, pull-requests: write and issues: write.
issue_comment workflows always run the default branch's workflow file
with a write token. mode: approve never checks out or runs PR code. It reads the event
payload and calls the GitHub API, so keep the approve workflow free of checkout and build
steps.issue_comment runs with the base repo's token. The box only exists if the comment was
posted some other way, e.g. by an agent with requireApproval. Label approval on fork
PRs fails: the pull_request event gives them a read-only token too.| Input | Default | |
|---|---|---|
routes |
from the diff | Comma-separated, e.g. /,/pricing. Added to .ui-diff.json's routes. |
auto-routes |
true |
Pick routes from the changed files when none are given. false requires them. |
dev-command |
detected | Starts the app; {port} is replaced with the port. |
viewports |
desktop:1440x900,mobile:iPhone 13 |
|
color-schemes |
light |
e.g. light,dark |
mode |
comment |
comment, description (a section of the PR description), prune, or approve (the approve workflow) |
working-directory |
. |
Where the repo is checked out, if you used path: with checkout. |
base |
the PR's base commit | |
config |
.ui-diff.json |
|
summary |
automatic | Markdown file to use as the summary. |
assets-branch |
ui-diff-assets |
|
server-timeout |
180 |
Seconds to wait for each dev server. |
require-approval |
false |
true: set the ui-diff/design-review status and add an approval box (see Design review gate). |
approval-label |
design-approved |
Label that also approves. Use the same value in the approve workflow. |
github-token |
github.token |
Outputs: changed, added, removed, unchanged, errors, comment-url, report-dir,
and skipped (true for fork and Dependabot PRs). Playwright and Chromium are cached
between runs, and Chromium's system libraries are installed on Linux runners when missing.
The example workflow also uploads .ui-diff/report and the server logs as an artifact.
Everything is optional. To save the routes, dev command and other settings for next time,
add a .ui-diff.json at the repo root (the agent offers to write it after a run):
{
"devCommand": "pnpm dev --port {port}",
"routes": ["/", "/pricing", { "path": "/settings", "waitFor": "[data-testid=form]" }],
"colorSchemes": ["light", "dark"],
"mask": ["[data-testid=timestamp]"],
"storageState": ".ui-diff/auth.json"
}
config.md lists every option: viewports and devices,
clicks and other steps before a screenshot, masking and hiding noisy content, logins,
Storybook and Figma settings.
GitHub has no public API for the drag-and-drop image uploads you use in comments, so
ui-diff pushes the images to a ui-diff-assets branch in the same repo and links them from
there. They render inline, and in private repos only people with read access can see them.
scripts/prune.sh <pr> or the cleanup workflow removes one PR's images. UI_DIFF_PRUNE=1 removes the images of every closed PR on the next publish. You can also delete the branch at any time.tests/selftest.sh # ~30s: unit checks + the full pipeline on a fixture site (no network)
tests/selftest.sh --full # ~1 min more: also a real Vite + React app and a real Storybook
tests/selftest.sh --keep # keep the temp repos for inspection
The fast tier builds throwaway git repos from tests/fixtures/ and checks what the skill
promises: measured style, copy and contrast changes, new and unchanged pages, no false
positives on a non-visual change, labelling of uncommitted changes, publishing and pruning
against a local bare remote, the automatic summary, the Action's script with a fake PR event,
and that servers and worktrees are cleaned up while unrelated processes are left alone.
Nothing touches GitHub. CI runs the full tier on Ubuntu and macOS for every push and PR.
evals/ holds prompts that should and shouldn't make an agent load the skill.scripts/release.sh 0.3.0 [notes.md] bumps the version in plugin.json and SKILL.md, runs the tests, tags v0.3.0, moves v0 (what uses: davidamunga/ui-diff@v0 follows) and creates the GitHub release.docs/brand/.install.sh install for every detected agent
action.yml GitHub Action (runs action/ci.sh)
action/ci.sh the pipeline with no agent: run → publish → comment → post, or prune
examples/workflows/ workflows to copy: ui-diff.yml, ui-diff-cleanup.yml, ui-diff-approve.yml
examples/demo-app/ sample React app for example PRs (not installed with the skill)
skills/ui-diff/
├── SKILL.md the workflow the agent follows
├── LICENSE.txt MIT (a copy that travels with the skill folder)
├── scripts/
│ ├── run.sh the whole pipeline: worktrees → servers → capture → diffs
│ ├── setup.sh one-time toolchain install
│ ├── devcmd.cjs detect the dev-server command and port flag
│ ├── linkdeps.cjs reuse installed deps in a worktree without sharing build caches
│ ├── routes.cjs changed files → routes to capture (per framework)
│ ├── imports.cjs import graph shared by routes.cjs and stories.cjs
│ ├── stories.cjs Storybook mode: changed files → stories to capture
│ ├── capture.cjs deterministic screenshots + computed-style snapshots
│ ├── diff.cjs pixel diff, changed regions, zoom crops
│ ├── stylediff.cjs measured style/layout/copy/contrast changes
│ ├── figma-export.cjs export a Figma frame as PNG (REST API, FIGMA_TOKEN)
│ ├── compare.cjs design vs implementation: composite, regions, zooms
│ ├── annotate.cjs "Flow change" / "Visual only" tag + note on each animation
│ ├── viewer.cjs local before/after review page (index.html)
│ ├── publish.sh push images to the assets branch
│ ├── prune.sh remove a closed PR's images from it
│ ├── assets.sh shared by both: throwaway clone, single-commit push
│ ├── comment.cjs render the PR markdown
│ ├── post.cjs create or update the PR comment / description section
│ └── review.cjs design review gate: commit status, approve by box or label
└── references/
├── route-mapping.md changed files → routes (and stories), per framework
├── config.md .ui-diff.json options, auth, noise control
└── figma.md comparing with a Figma design
tests/ selftest.sh, spec check, fixtures
evals/ trigger evals
docs/ demo image, brand assets (from Figma)
scripts/release.sh cut a release
MIT. See LICENSE.
davidamunga/ui-diff is a public repo on GitHub by davidamunga. Before/after screenshots, pixel diffs and a UX summary for UI changes in a PR — an Agent Skill for Claude Code, Codex, Cursor, Copilot and more.
It declares the MIT license on GitHub.
Its maker has not tagged a system, so it is unknown here. Its README says what it needs.
Open "Take it" on its page: Take My Repo writes an install plan for your machine and hands it to your AI agent (Claude Code, Codex or Cursor), which asks you before each step. Take My Repo has not tested it on any machine.
Its last change on GitHub was on 2026-11-19. Take My Repo does not judge from that whether it is maintained.
Nobody has reviewed it on Take My Repo yet, which says nothing about its quality.
Reverse engineer anything with agents, from app behavior down to native binaries.
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Ryugi (ryoo-ghee) — Interactive Artifacts for Coding Agents: artboards of mockups, design docs, whiteboards, HTML benches and verify reports you comment on, with every comment sent back to the agent.

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

The open-source app everyone uses to manage agents at work
Kenya’s counties, sub-counties, constituencies, wards, localities and areas as typed, offline libraries for JavaScript, React, Kotlin, Swift, Dart, PHP, .NET, Python and Go, with typo-tolerant search.

mpesa2csv - convert your mpesa statements to excel/csv files


Mirror and control an Android phone from your Mac inside a realistic device frame. A native Rust client for the scrcpy server.
This page is also available as structured data, with the same sources and dates.
/api/v1/resources/gh/davidamunga/ui-diffTake My Repo has not tested this on your machine. Requirements come from the project's own documentation.