git-hunk 0.1.3

Non-interactive hunk staging for AI agents
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60

# git-hunk

`git-hunk` is a small Rust CLI for non-interactive hunk staging.

It lets you scan diffs, inspect exact changes, stage or unstage precise selections, and preview commits without using `git add -p`.

## Install

From crates.io:

```bash
cargo install git-hunk
```

From GitHub:

```bash
cargo install --git https://github.com/nexxeln/git-hunk.git
```

Binary installer:

```bash
curl -fsSL https://raw.githubusercontent.com/nexxeln/git-hunk/main/install.sh | sh
```

## Commands

- `scan` lists selectable hunks and changes and returns a `snapshot_id`
- `show` prints a hunk, `change_id`, or `change_key`
- `resolve` maps a file and line hint to matching selectors
- `validate` checks whether selectors still match the current snapshot
- `stage` stages selected hunks, changes, change keys, or line ranges
- `unstage` removes selected hunks, changes, change keys, or line ranges from the index
- `commit` stages a selection and commits it, or previews it with `--dry-run`

## Example

```bash
git-hunk scan --mode stage --compact --json
git-hunk show --mode stage <change-key> --json
git-hunk stage --snapshot <snapshot-id> --change-key <change-key> --dry-run --json
git-hunk stage --snapshot <snapshot-id> --change-key <change-key> --json
```

## Notes

- Mutating commands require a fresh `snapshot_id`
- `change_id` is snapshot-bound; `change_key` is more stable across rescans
- Unsupported paths like conflicts, renames, and binary diffs are reported instead of forced through

## Build

```bash
cargo build
```

## Release

On every push to `main`, GitHub Actions runs tests, publishes a new crates.io version when `Cargo.toml` has an unpublished version, and creates a matching GitHub release with binary archives.