{"id":32948870,"url":"https://github.com/tomodian/release","last_synced_at":"2026-03-10T20:53:07.394Z","repository":{"id":43379167,"uuid":"280085398","full_name":"tomodian/release","owner":"tomodian","description":"A command-line utility to manage Keep-a-changelog formatted changelogs. Written in Go, works nicely on Monorepo.","archived":false,"fork":false,"pushed_at":"2024-12-08T06:55:32.000Z","size":133,"stargazers_count":14,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"develop","last_synced_at":"2024-12-08T07:25:07.454Z","etag":null,"topics":["changelog","cli","devops","go","keep-a-changelog","keepachangelog","linux","macos","monorepo","release-automation","release-management"],"latest_commit_sha":null,"homepage":"https://github.com/tomodian/release","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tomodian.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2020-07-16T07:30:18.000Z","updated_at":"2024-12-08T06:55:35.000Z","dependencies_parsed_at":"2024-06-19T19:07:25.604Z","dependency_job_id":"27202adb-3333-4383-9572-8888e92a2781","html_url":"https://github.com/tomodian/release","commit_stats":{"total_commits":83,"total_committers":3,"mean_commits":"27.666666666666668","dds":0.03614457831325302,"last_synced_commit":"34efa27066dac9fe489aea5c875354703fde1191"},"previous_names":[],"tags_count":33,"template":false,"template_full_name":null,"purl":"pkg:github/tomodian/release","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomodian%2Frelease","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomodian%2Frelease/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomodian%2Frelease/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomodian%2Frelease/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tomodian","download_url":"https://codeload.github.com/tomodian/release/tar.gz/refs/heads/develop","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tomodian%2Frelease/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":284115870,"owners_count":26949957,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-11-12T02:00:06.336Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["changelog","cli","devops","go","keep-a-changelog","keepachangelog","linux","macos","monorepo","release-automation","release-management"],"created_at":"2025-11-12T20:00:35.671Z","updated_at":"2025-11-12T22:00:45.843Z","avatar_url":"https://github.com/tomodian.png","language":"Go","funding_links":[],"categories":["Utilities","公用事业公司"],"sub_categories":["Utility/Miscellaneous","实用程序/Miscellaneous"],"readme":"# Release\n\n[![Go Reference](https://pkg.go.dev/badge/github.com/tomodian/release.svg)](https://pkg.go.dev/github.com/tomodian/release)\n[![Test on Linux](https://github.com/tomodian/release/actions/workflows/test.linux.yml/badge.svg)](https://github.com/tomodian/release/actions/workflows/test.linux.yml)\n[![Release](https://github.com/tomodian/release/actions/workflows/release.yml/badge.svg)](https://github.com/tomodian/release/actions/workflows/release.yml)\n[![codecov](https://codecov.io/gh/tomodian/release/branch/develop/graph/badge.svg)](https://codecov.io/gh/tomodian/release)\n\n[![GitHub All Releases](https://img.shields.io/github/downloads/tomodian/release/total?style=social)](https://github.com/tomodian/release/releases)\n\nA small command-line utility to manage CHANGELOG.md written in [keepachangelog.com](https://keepachangelog.com) format.\n\nWorks nicely on any sized Git repository, even awesome on [Monorepo](https://en.wikipedia.org/wiki/Monorepo).\n\n## Installation\n\nPlease download ZIP archive from [releases](https://github.com/tomodian/release/releases) page.\n\n## How it works\n\nRun `release` to show full list of commands and flags.\n\n### List all CHANGELOG.md\n\n`release target` will show you all CHANGELOG.md files recursively.\n\n```bash\nrelease target\nrelease target --dir path/to/entrypoint\nrelease t -d path/to/entrypoint\n```\n\n### See unreleased changes\n\n`release unreleased` will grab `[Unreleased]` sections of all CHANGELOG.md files recursively.\n\n```bash\nrelease unreleased\nrelease unreleased --dir path/to/entrypoint\nrelease u -d path/to/entrypoint\n```\n\n### See previous versions\n\n`release show` will output all previous version histories.\n\n```bash\nrelease show -v 0.1.0\nrelease show -v 0.1.0 --dir path/to/entrypoint\nrelease s -v 0.1.0 -d path/to/entrypoint\n```\n\n### Show the latest released version in current directory\n\n```bash\nrelease latest\nrelease latest --newline=false\nrelease l\n```\n\n### Bump all [Unreleased] sections to given version\n\nBy default, `release to -v X.Y.Z` will ask you for confirmation.\n\n```bash\nrelease to -v 0.2.0\n\n# Targets\n## .github/workflows/CHANGELOG.md\n## CHANGELOG.md\n✔ Enter `yes` to update all CHANGELOGs to version [0.8.0]: yes\n```\n\nIf you want to integrate with CI pipeline, use `--force` or `-f`.\n\n```bash\nrelease to -v 0.2.0 --force\n\n# Targets\n## .github/workflows/CHANGELOG.md --\u003e ✅\n## CHANGELOG.md --\u003e ✅\nDone👍\n```\n\n### See next release version\n\n`release next` will suggest you the next available version.\n\n```bash\nrelease next\n\nLatest released version: 0.8.0\n\nSuggestions for next release:\n- Major / Release --\u003e 1.0.0\n- Minor / Feature --\u003e 0.9.0\n- Patch / Hotfix  --\u003e 0.8.1\n```\n\nFor CI integrations, add `--type` flag.\nThe words `major`, `minor` and `patch` comes from [Semantic Versioning 2.0.0](https://semver.org) idiom.\n\n```bash\nrelease next --type major\n1.0.0\n\nrelease next --type minor\n0.9.0\n\nrelease next --type patch\n0.8.1\n```\n\nNote this command will not add newline when `--type` flag is specified.\nUse `--newline` flag if you prefer to see the newline.\n\n```bash\nrelease next --type major --newline\n```\n\n[GitFlow](https://www.atlassian.com/git/tutorials/comparing-workflows/gitflow-workflow) idiom is also supported.\n\n```bash\nrelease next --type release\n1.0.0\n\nrelease next --type feature\n0.9.0\n\nrelease next --type hotfix\n0.8.1\n```\n\n### Github-style semver `vx.y.z`\n\nThe tool also supports [Github-style semver](https://semver.org/#is-v123-a-semantic-version):\n\n```bash\nrelease show -v v0.1.0\nrelease to -v v0.2.0\n```\n\n## Development\n\n### Run\n\n```bash\nmake run\n```\n\n### Test\n\n```bash\nmake test\n```\n\n### Build\n\n```bash\nmake build\n```\n\n## License\n\n[Mozilla Public License v2.0](LICENSE)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomodian%2Frelease","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftomodian%2Frelease","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftomodian%2Frelease/lists"}