Live terminal diffs while files change. Livediff is a lightweight Rust TUI companion to git diff for generators, refactors, migrations, formatters, and config edits.

git diff is great after the fact. Livediff shows what changes while another tool is still editing files.

Use it when you want immediate feedback during:

• code generators and template systems;
• formatters, migrations, and codemods;
• refactors that touch many files;
• documentation or config generation;
• terminal-first workflows where a GUI diff app is too heavy.

Livediff does not replace Git. It complements git diff by turning file changes into a live terminal view.

cargo install livediff
livediff .

Monitor a specific path or ignore noisy files:

livediff ./src
livediff . --ignore "target/" --ignore "*.tmp"

Try the zero-install browser demo: socket7.github.io/Livediff

It simulates the TUI, file changes, and real-time diff animations before you install anything.

• Real-time monitoring — native OS filesystem events via notify.
• Interactive TUI — terminal interface built with ratatui and crossterm.
• Character-level diffs — precise added/removed highlights using similar.
• Low idle footprint — event-driven redraws; no Electron or Node runtime.
• Smart filtering — respects .gitignore and accepts custom glob ignores.
• Zero-install preview — hosted interactive demo for quick evaluation.

See docs/use-cases.md for practical workflows:

• watching generated files;
• inspecting migration output;
• monitoring formatter/codemod changes;
• reviewing docs/config generation.

cargo install livediff

Homebrew is not a live install channel yet: no verified tap or formula is currently published for Livediff. Use Cargo (above) or a pre-built release archive until this section lists verified brew commands.

See #5 for the original packaging discussion.

Tagged releases provide Linux, macOS, and Windows archives when available:

github.com/SoCkEt7/Livediff/releases

Usage: livediff [OPTIONS] [PATH]

Arguments:
  [PATH]  The path to monitor [default: .]

Options:
  -i, --ignore <IGNORE>  Ignore files matching this glob pattern (can be used multiple times)
      --show-hidden      Show hidden files
      --no-ignore        Do not respect ignore files (.gitignore, .ignore, etc.)
      --no-ignore-parent Do not respect ignore files in parent directories
      --no-ignore-vcs    Do not respect git/VCS ignore files (.gitignore, etc.)
  -h, --help             Print help
  -V, --version          Print version

• More packaged install options, including Homebrew.
• Short terminal recording with asciinema.
• More workflow recipes for generators, migrations, and monorepos.
• Community-requested filters and export options.

Contributions are welcome. Start with CONTRIBUTING.md, or open an issue with the workflow you want Livediff to support better.

Licensed under either MIT or Apache-2.0, at your option.