diffity-tree
nilbuild/diffity
Browse and comment on repository files in an interactive web-based file tree.
What is diffity-tree?
Diffity Tree opens a local web browser interface for exploring your repository's file structure and leaving inline comments. Use it when you need to review, annotate, or discuss specific files with context.
- Launch a local web server serving an interactive file tree browser
- Reuse existing diffity instances for the same repository
- Display repository files with full context for review
- Enable inline commenting on files
- Provide a clean URL for accessing the browser interface
How to install diffity-tree
npx skills add https://github.com/nilbuild/diffity --skill diffity-tree- Node.js and npm installed
- Git repository initialized in the current directory
How to use diffity-tree
- 1.Run the diffity-tree skill to start the file tree browser
- 2.Open the provided localhost URL in your web browser
- 3.Navigate the file tree to find files you want to review
- 4.Click on files to view their contents
- 5.Leave comments on files as needed
- 6.Return to your agent and run /diffity-resolve-tree to process the comments
Use cases
- Review code changes and leave comments on specific files before committing
- Annotate repository structure for documentation or onboarding
- Discuss file-level issues with team members via shared comments
- Explore large codebases with a visual file tree interface
- Mark files for follow-up work using the commenting system
- Developers reviewing code or exploring repositories
- Teams collaborating on code review with inline comments
- Technical leads documenting codebase structure
- Anyone needing a visual, browser-based file explorer for a Git repository
diffity-tree FAQ
The skill automatically installs diffity globally via npm if it is not found on your system.
The skill reuses existing instances for the same repository, so only one instance runs per repo. Starting diffity-tree again will open the existing browser window.
Comments are processed when you run the /diffity-resolve-tree skill after leaving them in the browser.
Diffity automatically selects an available port (typically starting at 5391) and displays the URL when the server starts.
This skill works on your local repository. Clone or pull the repository locally first, then run the skill from that directory.
Full instructions (SKILL.md)
Source of truth, from nilbuild/diffity.
name: diffity-tree description: Open the diffity file tree browser to browse and comment on repository files user-invocable: true
Diffity Tree Skill
You are opening the diffity file tree browser so the user can browse repository files in the browser.
Instructions
-
Check that
diffityis available: runwhich diffity. If not found, install it withnpm install -g diffity. -
Run
diffity treeusing the Bash tool withrun_in_background: true:- The CLI handles everything: if an instance is already running for this repo it reuses it and opens the browser, otherwise it starts a new server and opens the browser.
- Do NOT use
&or--quiet— let the Bash tool handle backgrounding.
-
Wait 2 seconds, then run
diffity list --jsonto get the port. -
Tell the user diffity tree is running. Print the URL and keep it short — don't show session IDs, hashes, or other internals. Example:
Diffity tree is running at http://localhost:5391
When you're ready:
- Leave comments on any file in your browser, then run /diffity-resolve-tree to fix them
Related skills
More from nilbuild/diffity and the wider catalog.
diffity-diff
Open an interactive diff viewer in your browser to visualize and comment on code changes.
diffity-learn
Learn any technical topic through interactive projects and guided tours.
diffity-resolve
Resolve code review comments by making requested fixes and changes.
diffity-resolve-tree
Resolve code review comments from diffity tree browser by making requested fixes
codex-ppt
Generate visually unified image-based PowerPoint decks from articles, reports, and outlines.
image-to-editable-ppt
Convert slide images, scanned PDFs, and image-based presentations into editable PowerPoint files with preserved speaker notes.