diffity 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md CHANGED
@@ -25,7 +25,14 @@ diffity main..feature # compare branches
25
25
  diffity v1.0.0..v2.0.0 # compare tags
26
26
  ```
27
27
 
28
- For the working tree, you can leave comments, copy them into your agent with a button and ask it to resolve them. Alternatively, use the skills below to avoid this manual step and let your agent auto-solve them.
28
+ New to git refs? Here's what the syntax means:
29
+
30
+ - `HEAD` is your current commit. `HEAD~1` means "one commit back", `HEAD~3` means "three commits back".
31
+ - `main..feature` means "what's in feature that's not in main" — exactly what a PR would show.
32
+ - `main..HEAD` means "what will my PR look like" — committed changes on your branch vs main.
33
+ - `diffity main` (no dots) compares main against your working tree, including uncommitted changes.
34
+
35
+ You can leave comments on any diff — working tree changes, branch comparisons, commit ranges. Copy them into your agent with a button and ask it to resolve them, or use the skills below to let your agent auto-review and auto-solve them.
29
36
 
30
37
  ## AI code review
31
38
 
@@ -39,16 +46,26 @@ Then use the slash commands:
39
46
 
40
47
  ### `/diffity-diff`
41
48
 
42
- Opens the diff viewer in your browser. Leave comments on any line — when you're done, run `/diffity-resolve` to have your agent fix them.
49
+ Opens the diff viewer in your browser. Optionally pass a ref:
50
+
51
+ ```
52
+ /diffity-diff # working tree changes
53
+ /diffity-diff main..feature # branch diff
54
+ /diffity-diff last 3 commits # natural language works too
55
+ ```
56
+
57
+ Leave comments on any line — when you're done, run `/diffity-resolve` to have your agent fix them.
43
58
 
44
59
  ### `/diffity-review`
45
60
 
46
- Your agent reviews the diff and leaves comments in the viewer. Uses severity tags: `[must-fix]`, `[suggestion]`, `[nit]`, `[question]`. You can focus on a specific area:
61
+ Your agent reviews the diff and leaves comments in the viewer. Uses severity tags: `[must-fix]`, `[suggestion]`, `[nit]`, `[question]`. Supports refs, focus areas, and natural language:
47
62
 
48
63
  ```
49
- /diffity-review security
50
- /diffity-review performance
51
- /diffity-review naming
64
+ /diffity-review # review working tree
65
+ /diffity-review main..feature # review branch diff
66
+ /diffity-review security # focus on security
67
+ /diffity-review main to feature # natural language
68
+ /diffity-review what I'm merging into main # also works
52
69
  ```
53
70
 
54
71
  ### `/diffity-resolve`