Open Source · Built with Rust

Git changes, streamed in real-time

A terminal UI that watches your repository and streams diffs as they happen. Perfect for monitoring AI agents, builds, and automated processes.

Get Started View on GitHub

hunky — ~/my-project

───── src/app.rs (2 new / 5 total) ─────
@@ -42,6 +42,8 @@
fn handle_event(&mut self, event: Event) {
match event {
+ Event::FileChanged(path) => {
+ self.refresh_diff(&path);
+ }
- Event::Tick => {}
_ => {}
}
}

▸ Watching for changes… Mode: Auto-Stream Speed: Medium

Features

Everything you need to watch code evolve

Hunky gives you a real-time window into your repository, surfacing exactly the changes you care about.

👁️

Real-time Watching

File system watcher detects changes to git-tracked files instantly. See diffs the moment they happen.

🎯

Smart Hunk Tracking

Intelligent "seen" tracking surfaces only new changes you haven't viewed yet. Never miss an update.

📊

Stream Display

Shows one hunk at a time with context lines and colored backgrounds for additions and deletions.

🎮

Interactive Modes

Auto-stream for hands-free watching, or buffered mode for manual navigation with keyboard controls.

⚡

Dynamic Speed Control

Fast, medium, or slow — timing adapts to hunk size so larger changes get more reading time.

🗂️

File Grouping

Changes organized by file with unseen/total counts. Tab between the file list and diff view.

Installation

Get up and running in seconds

Choose the installation method that works best for your setup.

# Run directly without installing
nix run github:randymarsh77/hunky

# Or add to your flake inputs
hunky.url = "github:randymarsh77/hunky";

# Then use the package
hunky.packages.${system}.default

Requires Nix with flakes enabled. This is the recommended install method for reproducible builds.

# Download the latest release for your platform
# from the GitHub Releases page

# macOS (Apple Silicon)
curl -LO https://github.com/randymarsh77/hunky/releases/latest/download/hunky-aarch64-apple-darwin.tar.gz
tar xzf hunky-aarch64-apple-darwin.tar.gz

# Linux (x86_64)
curl -LO https://github.com/randymarsh77/hunky/releases/latest/download/hunky-x86_64-unknown-linux-gnu.tar.gz
tar xzf hunky-x86_64-unknown-linux-gnu.tar.gz

# Move to your PATH
sudo mv hunky /usr/local/bin/

Check the Releases page for all available platforms and versions.

# Clone the repository
git clone https://github.com/randymarsh77/hunky.git
cd hunky

# Build with Cargo
cargo build --release

# The binary will be at target/release/hunky
./target/release/hunky --help

Requires the Rust toolchain (cargo, rustc). Use nix develop for a pre-configured environment.

Use Cases

Built for developers who want to see what's changing

🤖 AI Agent Monitoring

Watch in real-time as coding agents modify your repository. See every change the moment it lands.

🔧 Build Observation

See what files are generated or modified during build processes and code generation steps.

📝 Code Review

Stream through changes in an organized, paced manner — one hunk at a time, grouped by file.

📚 Learning

Understand how changes propagate through a codebase by watching edits flow across files.