Skip to main content

kratos changelog

Get Kratos release notes or commits information from the GitHub repository.

Usage

kratos changelog [version]

Description

The changelog command retrieves release information or commit history from the Kratos GitHub repository. You can view the latest release notes, a specific version’s changelog, or recent development commits.

Arguments

version
string
default:"latest"
The version to get changelog for. Can be:
  • latest - Get the most recent release (default)
  • dev - Get recent commits from the development branch
  • v2.x.x - Get a specific version’s release notes

Flags

--repo-url
string
default:"https://github.com/go-kratos/kratos.git"
GitHub repository URLShort flag: -r

Environment Variables

GITHUB_TOKEN
string
GitHub personal access token for API authentication (optional but recommended to avoid rate limits)
KRATOS_REPO
string
Override the default Kratos repository URL

Examples

Get Latest Release Notes

kratos changelog
This retrieves the changelog for the most recent Kratos release.

Get Development Commits

kratos changelog dev
This shows recent commits from the main development branch, useful for tracking what’s coming in the next release.

Get Specific Version

kratos changelog v2.7.0
Retrieves the release notes for version v2.7.0.

Use Custom Repository

kratos changelog --repo-url https://github.com/myorg/kratos-fork.git
Get changelog from a forked repository.

With GitHub Token

export GITHUB_TOKEN=ghp_xxxxxxxxxxxx
kratos changelog
Using a GitHub token helps avoid API rate limits when checking for releases.

Output Format

The command outputs:
  • For releases: Version number, release date, and release notes/changelog
  • For dev commits: List of recent commits with commit hashes, authors, and commit messages

Use Cases

Check What's New

See new features and fixes in the latest release

Version Planning

Review changes before upgrading to a new version

Development Tracking

Monitor recent commits and upcoming features

Release Notes

Generate changelog information for documentation

Notes

The command fetches data from GitHub’s API. Without a GITHUB_TOKEN, you may hit rate limits after a few requests.
For frequent use, create a GitHub personal access token with public_repo scope and set it in your environment.

Build docs developers (and LLMs) love