version-assist

What is this?
A CLI tool to generate Change log / code reviews using GitHub Copilot CLI. It extracts git diffs from repo and prompts Copilot to analyze the changes, then saves the output in markdown files.

Quick start

Installation

# install this package
npm i -g version-assist

# intsall github co-pilot cli if not installed (required)
npm install -g @github/copilot

# if you just install copilot-cli you should prompt "copilot" and login to authorize you device, otherwise it will have no output.

Cli usage

# show help
npx ver -h

# run code review agent
npx ver --agent=code-review

# generate changelog by branch compare
npx ver --agent=change-log --model=gpt-5-mini --compare=origin/main

Common options:

• --help, -h : Show help message
• --model <model> : Model to use (default: gpt-5-mini)
• --agent <agent> : code-review or change-log (default: code-review)
• --commit <sha> : Analyze a specific commit
• --compare <ref> : Compare a ref (e.g. main..feature-branch)