wigolo diff
Structural comparison of two page versions. Point it at a live URL and its cached copy, two URLs, or two raw markdown blobs, and it returns a git-style patch, structured per-section hunks, or a counts-only summary.
Quick Reference
// Live page vs its cached version (re-fetches `new` side)
{ "old": { "url": "https://docs.example.com/api" }, "new": { "url": "https://docs.example.com/api" } }
// Two different URLs
{ "old": { "url": "https://v1.example.com/spec" }, "new": { "url": "https://v2.example.com/spec" } }
// Two markdown blobs directly
{ "old": { "markdown": "# Title\nold body" }, "new": { "markdown": "# Title\nnew body" } }
// Structured per-section hunks at word granularity
{ "old": { "url": "https://example.com" }, "new": { "url": "https://example.com" }, "output": "hunks", "granularity": "word" }
// Counts only
{ "old": { "url": "https://example.com" }, "new": { "url": "https://example.com" }, "output": "summary" }
Parameters
| Parameter |
Type |
Default |
When to use |
old |
object |
required |
Left-hand side. One of { url, markdown, content_hash } |
new |
object |
required |
Right-hand side. One of { url, markdown } |
output |
string |
"unified" |
"unified" (git-style patch), "hunks" (per-section), "summary" (counts only) |
granularity |
string |
"line" |
"line", "word" (changed tokens only — tighter), "section" (walks H1/H2/H3) |
Output Shapes
unified — a git-style unified patch, ready to read or store.hunks — structured per-section change blocks. Combine with granularity: "section" to align hunks to headings, or granularity: "word" for tight intra-line edits.summary — counts only: added_lines, removed_lines, modified_lines, and total_changed_chars (sum of added + removed line chars across the edit script). Cheapest way to answer "did anything change, and how much".
Comparing Against the Cache
The most common use is drift detection: fetch a page now and diff it against the copy wigolo cached earlier. Pass the same URL for both sides — wigolo reads the cached body for old and re-fetches for new. For a scoped, multi-URL sweep, prefer cache with check_changes: true.
Anti-Patterns
- DON'T pass an
old/new object without one of the accepted side keys — the handler rejects it.
- DON'T use
output: "unified" when you only need counts — summary is cheaper.
- DON'T diff two unrelated pages expecting a meaningful changelog — diff versions of the same content.
When NOT to use wigolo-diff
- Bulk change detection across many cached URLs — use
cache with check_changes: true.
- Ongoing scheduled monitoring — use
watch, which diffs on each check.
See Also
1---2name: wigolo-diff3description: Compare two versions of a page and see exactly what changed — a live URL against its cached copy, two URLs, or two markdown blobs. Section-level hunks, word- or line-level granularity, or a summary of counts. Use when the user says "what changed", "diff these", "compare this page to last time", "show me the changes", "did this doc update", or wants a changelog between two versions of the same content.4license: AGPL-3.0-only5---67# wigolo diff89Structural comparison of two page versions. Point it at a live URL and its cached copy, two URLs, or two raw markdown blobs, and it returns a git-style patch, structured per-section hunks, or a counts-only summary.1011## Quick Reference1213```json14// Live page vs its cached version (re-fetches `new` side)15{ "old": { "url": "https://docs.example.com/api" }, "new": { "url": "https://docs.example.com/api" } }1617// Two different URLs18{ "old": { "url": "https://v1.example.com/spec" }, "new": { "url": "https://v2.example.com/spec" } }1920// Two markdown blobs directly21{ "old": { "markdown": "# Title\nold body" }, "new": { "markdown": "# Title\nnew body" } }2223// Structured per-section hunks at word granularity24{ "old": { "url": "https://example.com" }, "new": { "url": "https://example.com" }, "output": "hunks", "granularity": "word" }2526// Counts only27{ "old": { "url": "https://example.com" }, "new": { "url": "https://example.com" }, "output": "summary" }28```2930## Parameters3132| Parameter | Type | Default | When to use |33|-----------|------|---------|-------------|34| `old` | object | required | Left-hand side. One of `{ url, markdown, content_hash }` |35| `new` | object | required | Right-hand side. One of `{ url, markdown }` |36| `output` | string | "unified" | "unified" (git-style patch), "hunks" (per-section), "summary" (counts only) |37| `granularity` | string | "line" | "line", "word" (changed tokens only — tighter), "section" (walks H1/H2/H3) |3839## Output Shapes4041- **`unified`** — a git-style unified patch, ready to read or store.42- **`hunks`** — structured per-section change blocks. Combine with `granularity: "section"` to align hunks to headings, or `granularity: "word"` for tight intra-line edits.43- **`summary`** — counts only: `added_lines`, `removed_lines`, `modified_lines`, and `total_changed_chars` (sum of added + removed line chars across the edit script). Cheapest way to answer "did anything change, and how much".4445## Comparing Against the Cache4647The most common use is drift detection: fetch a page now and diff it against the copy wigolo cached earlier. Pass the same URL for both sides — wigolo reads the cached body for `old` and re-fetches for `new`. For a scoped, multi-URL sweep, prefer `cache` with `check_changes: true`.4849## Anti-Patterns5051- DON'T pass an `old`/`new` object without one of the accepted side keys — the handler rejects it.52- DON'T use `output: "unified"` when you only need counts — `summary` is cheaper.53- DON'T diff two unrelated pages expecting a meaningful changelog — diff versions of the same content.5455## When NOT to use wigolo-diff5657- **Bulk change detection across many cached URLs** — use `cache` with `check_changes: true`.58- **Ongoing scheduled monitoring** — use `watch`, which diffs on each check.5960## See Also6162- [wigolo-cache](../wigolo-cache/SKILL.md) — `check_changes` for bulk drift detection63- [wigolo-watch](../wigolo-watch/SKILL.md) — scheduled change monitoring64- [wigolo-fetch](../wigolo-fetch/SKILL.md) — pull a fresh version to compare
knockoutez