revdiff

Resolve and orchestrate terminal-based diff reviews across Git, Hg, and JJ repos.

1|Updated May 20, 2025
One-click install
npx skills add https://github.com/vessux/dotfiles --skill revdiff
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: revdiff
Source: https://github.com/vessux/dotfiles/tree/main/umbel/skills/umputun/revdiff
Command: npx skills add https://github.com/vessux/dotfiles --skill revdiff

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires git, jj, hg, jq, revdiff, and includes scripts (resource) and references (resource) components.

What problem does it solve?

Reviewers and developers need a streamlined way to examine diffs and add inline annotations directly in a terminal, across multiple VCS backends.

Core Features & Use Cases

  • TUI diff review with inline annotations in git, hg, and jj repos
  • Open in overlays across tmux, Zellij, kitty, wezterm, and more
  • Reference and apply annotation-driven review workflows with built-in help and history

Quick Start

Launch revdiff to start reviewing diffs and annotating changes in a terminal overlay.

Frequently Asked Questions about revdiff

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I review git diffs and add inline annotations directly in the terminal?

You can resolve and orchestrate terminal-based diff reviews across Git, Hg, and JJ repositories using a TUI overlay. It supports inline annotations, history tracking, and built-in reference materials to guide your review workflow.

Can I use a terminal diff review tool across both Git and JJ version control systems?

Yes, terminal diff review can operate across multiple VCS backends including Git, Hg, and JJ repositories. It orchestrates diff resolution and annotation workflows uniformly across these different version control environments.

Does terminal diff review work with tmux, Zellij, and kitty terminal overlays?

Yes, terminal diff review opens in overlays across tmux, Zellij, kitty, wezterm, and other terminal multiplexers. It renders a TUI overlay to display diffs and capture inline annotations within your existing shell environment.

What do I need to install to start annotating diffs in a terminal environment?

You need Git, JJ, Hg, jq, and the revdiff utility installed to annotate diffs in a terminal environment. These dependencies enable the TUI overlay to resolve diffs and apply annotations across various version control backends.

What is the best way to manage diff review workflows across multiple VCS backends?

Managing diff review workflows across multiple VCS backends is best handled by a TUI overlay that enforces safety by reading reference materials and handling multi-tool environments, ensuring consistent annotation and history tracking across Git, Hg, and JJ.

Are there limitations when using terminal-based diff review in multi-tool environments?

Limitations in terminal-based diff review arise from handling multi-tool environments with Git, Hg, and JJ. The tool mitigates these by enforcing safety protocols and reading built-in reference materials to ensure correct usage across different shells.