{"id":19850504,"url":"https://github.com/mroth/bump","last_synced_at":"2025-08-17T21:15:19.110Z","repository":{"id":39890197,"uuid":"184934637","full_name":"mroth/bump","owner":"mroth","description":"🌻 CLI tool to draft a GitHub Release for the next semantic version","archived":false,"fork":false,"pushed_at":"2025-07-22T15:20:16.000Z","size":358,"stargazers_count":48,"open_issues_count":2,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-22T16:24:55.164Z","etag":null,"topics":["git","github","github-releases","release-automation","semantic-versioning","semver"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mroth.png","metadata":{"files":{"readme":"README.md","changelog":null,"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,"zenodo":null},"funding":{"github":"mroth"}},"created_at":"2019-05-04T19:09:56.000Z","updated_at":"2025-06-21T17:36:51.000Z","dependencies_parsed_at":"2023-02-08T09:16:43.972Z","dependency_job_id":"2c50f4cc-1a37-4ec1-aafd-26eea4e1850d","html_url":"https://github.com/mroth/bump","commit_stats":{"total_commits":105,"total_committers":3,"mean_commits":35.0,"dds":"0.34285714285714286","last_synced_commit":"96e017d64a188daf4a1b5f28318e3222d2bcef88"},"previous_names":[],"tags_count":9,"template":false,"template_full_name":null,"purl":"pkg:github/mroth/bump","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mroth%2Fbump","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mroth%2Fbump/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mroth%2Fbump/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mroth%2Fbump/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mroth","download_url":"https://codeload.github.com/mroth/bump/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mroth%2Fbump/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270907429,"owners_count":24665962,"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-08-17T02:00:09.016Z","response_time":129,"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":["git","github","github-releases","release-automation","semantic-versioning","semver"],"created_at":"2024-11-12T13:26:23.415Z","updated_at":"2025-08-17T21:15:19.100Z","avatar_url":"https://github.com/mroth.png","language":"Go","readme":"# bump :sunflower:\n\nSimple, cross-platform CLI tool to help draft a [GitHub Release] for the next\n[semantic version] of your project.\n\n- Zero runtime dependencies (not even git).\n- Auto-detects current repo if in cloned repository.\n- Can work without any API authorization at all.\n\nThis is intentionally designed to work with the GitHub web site interface for\ndrafting releases, and does not even require you to have the source code checked\nout locally.\n\n[GitHub Release]: https://help.github.com/en/articles/about-releases\n[semantic version]: https://semver.org\n\n## Usage\n\n```\n$ bump --help\nUsage: bump \u003cowner\u003e \u003crepo\u003e\n\nIf you are in a git repository that has been cloned from GitHub, owner and\nrepo args can be omitted, in which case they will be inferred from the remote\norigin.\n\nFlags:\n    --no-open           Do not automatically open publish URL in browser.\n    --verbose, -v       Verbose output.\n    --version           Print version and exit.\n    --help              Print help and exit.\n\nEnvironment:\n    $BUMP_NO_OPEN       Global default for --no-open\n    $BUMP_VERBOSE       Global default for --verbose\n    $GITHUB_TOKEN       Optional, will use if present to access private repos\n```\n\nDoing this:\n\n![animation](docs/demo.svg)\n\n:arrow_right: Automatically opens this in your browser:\n\n![release-page-ss](docs/release-draft.png)\n\nWhere you can edit your release notes before clicking **Publish Release**.\n\nAfterwards, if you have a local checkout of the repository, you may wish to do `git\nfetch` to pull all remote tags to your system. :eyes:\n\n## Installation\n\nDownload from the [Releases page](https://github.com/mroth/bump/releases) and\nput somewhere in your `$PATH`.\n\nHomebrew users can `brew install mroth/tap/bump`.\n\n## Comparison\n\nUnlike many of these release tools, bump is currently intended to support\nworkflows where rather than pushing tags locally, new releases are primarily\ndrafted via the Github Releases web interface (all the easier to drag your\nanimated GIFs in, and whatnot.)\n\nThis may not be the correct workflow for your project! In particular, it\nworks best in environments where there is not a version number file that is stored\nin version control itself (such as NPM, Cargo), but rather those where the git\ntags themselves manage the versioning (Go modules, sbt-git, etc.)\n\nSome related tools I found in looking at this you may wish to consider as\nalternatives:\n\n- [sindresorhus/np] For NPM projects, this is really good. We've adopted it for\n  all our JS native projects at @openlawteam, in conjunction with\n  `--no-publish`.\n- [goreleaser] For Go projects, this tool is quite nice. In fact, it works well\n  in partnership with bump: let bump manage your releases and changelog, and have\n  goreleaser running in CI to build and add the binaries to the release. (See\n  the configuration for this project.)\n- [zeit/release] Fairly close to what we wanted, but it does a git tag/commit\n  and pushes to GitHub before drafting the release, and requires API\n  authorization. Javascript based.\n\n[sindresorhus/np]: https://github.com/sindresorhus/np\n[goreleaser]: https://goreleaser.com\n[zeit/release]: https://github.com/zeit/release\n","funding_links":["https://github.com/sponsors/mroth"],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmroth%2Fbump","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmroth%2Fbump","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmroth%2Fbump/lists"}