A CLI tool for generating technical summaries of code changes using LLMs
Project description
vigilia
A CLI tool for generating technical summaries of code changes using LLMs.
vigilia takes git diffs, splits them into manageable fragments, and uses an LLM to produce readable documentation of what changed. It's designed for engineering teams who want to understand a codebase's evolution without reading every line of every diff.
Usage
Command line interface:
Process the git diff between the current HEAD and the main branch:
vigilia extract-patches <COMMIT_REF> HEAD --output out/patches
Assemble fragments from the generated patch files:
vigilia assemble-fragments out/patches --output out/fragments
Generate a consolidated summary from the assembled fragments:
vigilia summarize-fragments out/fragments --output out/summaries
The entire process can be run in one command:
vigilia summarise-changes <COMMIT_REF> HEAD --output out/
vigilia uses pydantic-ai, so any model it supports can be used by specifying the appropriate model identifier.
Licence
MIT
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file vigilia-2026.1.4.dev0.tar.gz.
File metadata
- Download URL: vigilia-2026.1.4.dev0.tar.gz
- Upload date:
- Size: 12.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.9.25 {"installer":{"name":"uv","version":"0.9.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
67d4abd88918540e6dbcd5c2f328909cb89f4502a5c66dc3e3c712b03902e14b
|
|
| MD5 |
76938ed8c5568aee8552ca1a228389c3
|
|
| BLAKE2b-256 |
0fa69f799c2c2788db075f2d83fc518e1192f22f0cee0d7afdddcb974c5010bb
|
File details
Details for the file vigilia-2026.1.4.dev0-py3-none-any.whl.
File metadata
- Download URL: vigilia-2026.1.4.dev0-py3-none-any.whl
- Upload date:
- Size: 16.9 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.9.25 {"installer":{"name":"uv","version":"0.9.25","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
899b8154146e88f50b31a5101263bbaaad40a5bcf8f26c0a49b9477739654583
|
|
| MD5 |
06ca5f7ec61ccbe9b62b818dad8f00ab
|
|
| BLAKE2b-256 |
4978475bdb0a556fdf9c7a8b44094e6dcfd6e74fda96e70856856d80ca9ffc9f
|
