Skip to content

salesforce-misc/wiff

Repository files navigation

wiff

Workspace diff. At a glance.


The world has changed. Your tooling should too.

AI agents are writing, refactoring, and committing code at a pace no IDE was designed for. The role of the developer is shifting — less time spent authoring every line, more time spent understanding what changed, why it changed, and whether it's right.

wiff is built for that shift.

It's a lightweight, read-only visualization tool for developers who want a single, clear view of everything their agents — or their teammates — have been touching across a working directory of repositories. Open a folder and wiff shows you the full tree of changes: what's uncommitted, what's untracked, and what's been committed locally but not yet pushed. Click a file. See the diff. That's it.

No write operations. No project files. No opinion about your editor, your build system, or your workflow. wiff gets out of the way and lets you focus on what matters: understanding the work.


Why wiff exists

Modern development increasingly spans many repositories at once — microservices, shared libraries, infrastructure, docs. When a feature touches several of them simultaneously, the usual tools don't compose well. You end up juggling multiple terminal windows, browser tabs, and git status outputs just to get a picture of what changed.

That overhead is manageable when you're writing every line yourself. It becomes untenable when AI agents are making changes faster than any human can manually track across a dozen repos in parallel.

wiff treats your working directory as a single unit of work, regardless of how many repositories it contains.


Change taxonomy

wiff categorizes every changed file into one of four states:

State Color Meaning
uncommitted default Modified or staged, not yet in a commit
untracked red New file git doesn't know about
untracked directory red New directory git doesn't know about
locally committed dark green Committed locally, not yet pushed to remote

For locally committed files, the first line of the commit message is shown inline — so you always know why a file was changed, not just that it was changed.


Usage

# Workspace mode: scan a folder containing multiple git repos
wiff ~/my-projects

# Single repo mode
wiff ~/my-projects/some-repo

Keyboard shortcuts in the diff panel:

  • Full File / Diff — toggle between full file view and the diff
  • 0 / 5 / 10 / 20 — adjust context lines shown around each change
  • — refresh to pick up new changes without restarting

Building

cargo build --release

Requires Rust 1.75+ and a working git installation on your PATH.


License

Apache 2.0. See LICENSE.

About

No description, website, or topics provided.

Resources

License

Code of conduct

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Generated from salesforce/oss-template