diffy-cli

Show an existing Diffy project's settings as YAML. Use when the user asks for project details, project settings, project config, "details on project <id>", or to view/get/show/export a project's configuration. Displays the exportable YAML (the dashboard "Export" format), never raw JSON.

Change settings for an existing Diffy project with the diffy CLI. Use when the user asks to update, edit, change, or apply Diffy project settings such as pages, URLs, environments, breakpoints, masks, delays, headers, cookies, login settings, schedules, or multiple project configs.

Compare two environments of a Diffy project server-side with project:compare — Diffy screenshots both environments on its own servers and produces a visual-regression diff, returning a diff ID. Use when the user wants to compare prod vs staging, prod vs a custom/PR/UAT URL, or two arbitrary URLs remotely, without capturing anything locally. This runs on Diffy's servers; to compare a locally running app on THIS machine instead, use the visual-diff skill. If the user is ambiguous about local vs remote, ask.

Create a Diffy visual diff from two existing screenshot set IDs with diff:create. Use when the user asks to compare screenshots, compare two uploaded screenshot sets, create a diff from screenshot IDs, or get a diff ID for before/after screenshots.

Create a Diffy project with the diffy CLI from user-provided project details. Use when the user asks to create a Diffy project, set up a new project in Diffy, or turn a base URL, pages, and breakpoints into a new Diffy project. Requires the user to provide base_url and returns the created project ID.

Fetch and summarize Diffy diff status, result JSON, changed percentage, per-page and per-breakpoint differences, JUnit output, or recent diff lists. Use when the user asks for diff info, diff results, changed pages, percent changed, report link, or whether a Diffy diff is complete.

Trigger Diffy to capture a screenshot set of a project environment on Diffy's own servers (no local browser, no Playwright) with screenshot:create, and return a screenshot ID. Use when the user asks to screenshot production/staging/development or a live custom URL remotely, take Diffy screenshots of an environment, or set a new remote baseline. This runs on Diffy's servers; to capture a locally running app on THIS machine instead, use the upload-screenshot skill. If the user is ambiguous about local vs remote capture, ask.

Capture a running app locally inside Diffy's screenshot-worker Docker container (the same rendering pipeline Diffy runs in production) and upload it to Diffy, returning a screenshot ID. Use when the user asks to capture a local or running app for Diffy, upload a current UI screenshot set, or create a Diffy screenshot ID from a live app URL. This captures on THIS machine; to have Diffy screenshot a deployed environment on its own servers instead, use the remote-screenshot skill. If the user is ambiguous about local vs remote capture, ask.

Capture before/after screenshots of a running UI inside Diffy's screenshot-worker Docker container (the same rendering pipeline Diffy runs in production) and produce a visual-regression diff with the Diffy CLI. Use when the user makes UI changes and wants to see what changed visually: run once BEFORE edits to set a baseline, then again AFTER edits to compare. Pages, breakpoints, and capture settings come from the Diffy project (no config file). Reports % changed per page/breakpoint plus a shareable diff report link. This captures on THIS machine (a running local app); to compare two already-deployed environments/URLs on Diffy's servers instead, use the compare-environments skill. If the user is ambiguous about whether to capture locally or remotely, ask. Trigger phrases: "visual diff", "compare the UI", "what changed visually", "screenshot diff", "did my UI change".