diffity 0.1.5 → 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.
Files changed (5) hide show
  1. package/README.md +29 -16
  2. package/dist/index.js +495 -102
  3. package/dist/ui/assets/{index-Dt_01AYh.js → index-BQK01Qmc.js} +38 -37
  4. package/dist/ui/index.html +1 -1
  5. package/package.json +2 -1
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
 
@@ -37,27 +44,33 @@ npx skills add kamranahmedse/diffity
37
44
 
38
45
  Then use the slash commands:
39
46
 
47
+ ### `/diffity-diff`
48
+
49
+ Opens the diff viewer in your browser. Optionally pass a ref:
50
+
40
51
  ```
41
- # use this skill to open the browser with diff viewer
42
- # you can review the code yourself and leave comments
43
- /diffity-start
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.
44
58
 
45
- # once done, you can come back to the agent and use the
46
- # below skill to ask agent to resolve your comments.
47
- /diffity-resolve
59
+ ### `/diffity-review`
48
60
 
49
- # you can use this to have AI review your uncommitted
50
- # changes and leave comments in the diff viewer
51
- /diffity-review
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:
62
+
63
+ ```
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
- The review uses severity tags so you know what matters:
55
- - `[must-fix]` — Bugs, security issues
56
- - `[suggestion]` — Meaningful improvements
57
- - `[nit]` — Style preferences
58
- - `[question]` — Needs clarification
71
+ ### `/diffity-resolve`
59
72
 
60
- You can focus the review on what you care about: `/diffity-review security` or `/diffity-review performance`
73
+ Reads all open comments and makes the requested code changes. Works with both your comments and AI review comments.
61
74
 
62
75
  ## Multiple projects
63
76