git-hunk

git-hunk

Non-interactive hunk staging for AI agents. A better git add.

Built with Bun + Bunli. TypeScript rewrite of nexxeln/git-hunk (Rust) — same core concepts (snapshots, change keys, hunk-level staging), redesigned for agent workflows.

What this solves over the Rust version

• --path selector — stage entire files without extracting change keys. Agents spent most of their time mapping files to change keys via python one-liners; now --path src/lib.ts,src/other.ts just works.
• --summary scan mode — file-level overview without hunks or changes. The orchestrator only needs filenames and line counts to form groups, not 649 change keys.
• Staging only, no commits — the Rust version bundled commit which mixed concerns. This version does one thing: stage precisely. Use regular git commit after.
• JS bundle distribution — no compiled binary issues. Runs anywhere Bun is installed. The Rust version required cargo or prebuilt binaries.
• Simpler codebase — ~1400 lines of TypeScript vs ~3900 lines of Rust, for equivalent functionality. Easier to iterate on.

Install

bun install

Usage

# File-level overview
git-hunk scan --summary --json

# Change-level detail
git-hunk scan --compact --json

# Stage whole files
git-hunk stage --snapshot <id> --path src/lib.ts,src/other.ts --json

# Stage specific changes
git-hunk stage --snapshot <id> --change-key ck_abc,ck_def --json

# Preview before staging
git-hunk stage --snapshot <id> --path src/lib.ts --dry-run --json

# Stage everything
git-hunk stage --snapshot <id> --all --json

# Inspect a change
git-hunk show <change-key> --json

# Unstage
git-hunk unstage --snapshot <id> --path src/lib.ts --json

Development

bun dev -- scan --summary --json
bun test
bun run typecheck