# semrel — Semantic Release Automation Without Node.js

> **semrel** is an open-source, zero-dependency semantic release automation tool written in Go.
> It is the **Go-native, language-agnostic alternative to `semantic-release`, `GoReleaser`, `release-please`, `release-it`, and `changesets`** — no Node.js, no npm, no `node_modules`.
> `semrel` parses Conventional Commits, calculates the next SemVer version (major/minor/patch), generates Keep-a-Changelog Markdown/HTML release notes, updates manifests across 15+ ecosystems, packages Linux `.deb`/`.rpm`/`.apk` artifacts, publishes to npm, PyPI, crates.io, Docker, and OCI registries, and creates releases on GitHub (including GHES), GitLab, Gitea/Forgejo, Bitbucket, or plain Git — in ~1.4 seconds as a single ~12 MB static binary.
> Every release and all **46 official plugins** are signed with Sigstore Cosign v3, include CycloneDX/SPDX SBOMs, carry SLSA Level 1 provenance, and work offline in air-gapped CI via `.semrel.lock`.

## Documentation

- [Home & Feature Overview](https://www.semrel.io/): Complete overview of semrel, 46 official plugins, and live pipeline demo.
- [Introduction & Comparison with alternatives](https://www.semrel.io/getting-started/introduction/): What semrel is, why no Node.js, and how it compares to semantic-release and GoReleaser.
- [semrel vs semantic-release vs GoReleaser vs release-please](https://www.semrel.io/guide/comparison/): Full 2026 feature matrix, performance benchmarks, and migration decision guide.
- [Installation](https://www.semrel.io/getting-started/installation/): Installing via Go, Docker (`ghcr.io/SemRels/semrel`), or static binary download.
- [Quick Start](https://www.semrel.io/getting-started/quick-start/): Run your first automated semantic release in 5 minutes.
- [Configuration Reference](https://www.semrel.io/guide/configuration/): Full `.semrel.yaml` schema reference, rules, scopes, and phases.
- [CLI Reference](https://www.semrel.io/guide/cli/): All `semrel` CLI commands (`release`, `workspace`, `plugin`, `commitlint`, `doctor`, `changelog`, `config`).
- [Monorepo Guide](https://www.semrel.io/guide/monorepo/): Independent and lockstep monorepo workspace versioning with dependency ordering.
- [Docker Usage](https://www.semrel.io/guide/docker/): Running semrel inside Distroless or Alpine Docker/CI containers.
- [CI Outputs](https://www.semrel.io/guide/ci-outputs/): Exporting release metadata in GitHub Actions and GitLab CI.
- [CI/CD Templates](https://www.semrel.io/guide/ci-cd-templates/): Copy-paste workflows for GitHub Actions, GitLab CI, Bitbucket Pipelines, CircleCI, and Gitea.

## Plugins & Migrations (46 Official Plugins)

- [Plugin Overview](https://www.semrel.io/plugins/overview/): Subprocess architecture, 8 categories, lifecycle phases, and environment variables.
- [Managing Plugins & Lockfiles](https://www.semrel.io/plugins/managing/): Installing, pinning with `.semrel.lock`, and air-gap restoring via `semrel plugin restore`.
- [Official Plugins Catalog](https://www.semrel.io/plugins/): All 46 officially maintained plugins.
- [Migration Hub](https://www.semrel.io/plugins/migration/): Guides for migrating from [semantic-release](https://www.semrel.io/plugins/migrations/semantic-release/), [GoReleaser](https://www.semrel.io/plugins/migrations/goreleaser/), and [release-please](https://www.semrel.io/plugins/migrations/release-please/).
- [Plugin Registry](https://www.semrel.io/plugins/registry/): Browsing and publishing plugins to `registry.semrel.io`.
- [Plugin SDK / Development](https://www.semrel.io/plugins/sdk/): Writing custom semrel plugins in Go or any language.
- [Publishing a Plugin](https://www.semrel.io/plugins/publishing/): Submitting a plugin to the global registry.

### Conditions (6)
- [condition-github-actions](https://www.semrel.io/plugins/conditions/condition-github-actions/) (GitHub.com, GHES & Data Residency)
- [condition-gitlab-ci](https://www.semrel.io/plugins/conditions/condition-gitlab-ci/)
- [condition-gitea-actions](https://www.semrel.io/plugins/conditions/condition-gitea-actions/)
- [condition-bitbucket-pipelines](https://www.semrel.io/plugins/conditions/condition-bitbucket-pipelines/)
- [condition-circleci](https://www.semrel.io/plugins/conditions/condition-circleci/)
- [condition-generic](https://www.semrel.io/plugins/conditions/condition-generic/)

### Analyzers (2)
- [analyzer-conventional](https://www.semrel.io/plugins/analyzers/analyzer-conventional/)
- [analyzer-default](https://www.semrel.io/plugins/analyzers/analyzer-default/)

### Generators (3)
- [generator-changelog-md](https://www.semrel.io/plugins/generators/generator-changelog-md/)
- [generator-changelog-html](https://www.semrel.io/plugins/generators/generator-changelog-html/)
- [generator-release-notes](https://www.semrel.io/plugins/generators/generator-release-notes/)

### Updaters (15)
- [updater-go](https://www.semrel.io/plugins/updaters/updater-go/)
- [updater-npm](https://www.semrel.io/plugins/updaters/updater-npm/)
- [updater-cargo](https://www.semrel.io/plugins/updaters/updater-cargo/)
- [updater-python](https://www.semrel.io/plugins/updaters/updater-python/)
- [updater-docker](https://www.semrel.io/plugins/updaters/updater-docker/)
- [updater-helm](https://www.semrel.io/plugins/updaters/updater-helm/)
- [updater-maven](https://www.semrel.io/plugins/updaters/updater-maven/)
- [updater-gradle](https://www.semrel.io/plugins/updaters/updater-gradle/)
- [updater-nuget](https://www.semrel.io/plugins/updaters/updater-nuget/)
- [updater-composer](https://www.semrel.io/plugins/updaters/updater-composer/)
- [updater-pubspec](https://www.semrel.io/plugins/updaters/updater-pubspec/)
- [updater-zig](https://www.semrel.io/plugins/updaters/updater-zig/)
- [updater-terraform](https://www.semrel.io/plugins/updaters/updater-terraform/)
- [updater-homebrew](https://www.semrel.io/plugins/updaters/updater-homebrew/)
- [updater-replace](https://www.semrel.io/plugins/updaters/updater-replace/)

### Packagers (1)
- [packager-nfpm](https://www.semrel.io/plugins/packagers/packager-nfpm/) (`.deb`, `.rpm`, `.apk` Linux packages)

### Publishers (6)
- [publisher-npm](https://www.semrel.io/plugins/publishers/publisher-npm/)
- [publisher-pypi](https://www.semrel.io/plugins/publishers/publisher-pypi/)
- [publisher-crates](https://www.semrel.io/plugins/publishers/publisher-crates/)
- [publisher-docker](https://www.semrel.io/plugins/publishers/publisher-docker/)
- [publisher-oci](https://www.semrel.io/plugins/publishers/publisher-oci/)
- [publisher-generic-http](https://www.semrel.io/plugins/publishers/publisher-generic-http/)

### Providers (5)
- [provider-github](https://www.semrel.io/plugins/providers/provider-github/)
- [provider-gitlab](https://www.semrel.io/plugins/providers/provider-gitlab/)
- [provider-gitea](https://www.semrel.io/plugins/providers/provider-gitea/)
- [provider-bitbucket](https://www.semrel.io/plugins/providers/provider-bitbucket/)
- [provider-git](https://www.semrel.io/plugins/providers/provider-git/)

### Hooks (8)
- [hook-discord](https://www.semrel.io/plugins/hooks/hook-discord/)
- [hook-slack](https://www.semrel.io/plugins/hooks/hook-slack/)
- [hook-teams](https://www.semrel.io/plugins/hooks/hook-teams/)
- [hook-matrix](https://www.semrel.io/plugins/hooks/hook-matrix/)
- [hook-email](https://www.semrel.io/plugins/hooks/hook-email/)
- [hook-jira](https://www.semrel.io/plugins/hooks/hook-jira/)
- [hook-exec](https://www.semrel.io/plugins/hooks/hook-exec/)
- [hook-gitplugin](https://www.semrel.io/plugins/hooks/hook-gitplugin/)

## API & Infrastructure

- [Registry API Reference](https://www.semrel.io/api/registry/): REST API for the plugin registry.
- [gRPC API](https://www.semrel.io/api/grpc/): gRPC interface documentation.
- [Web Service](https://www.semrel.io/infrastructure/web-service/): How the hosted semrel infrastructure is run.

## External Resources

- [GitHub Organisation](https://github.com/SemRels): All open-source repositories.
- [Core Repository](https://github.com/SemRels/semrel): `semrel` CLI & engine source code.
- [Discord Community](https://discord.gg/w8zTm2r3jg): Official Discord server with automatic Release Ping notifications, support, and plugin discussions.
- [Plugin Registry UI](https://registry.semrel.io): Browse and install community plugins.
- [Registry API](https://registry.semrel.io/api/v1/plugins): Machine-readable plugin list (JSON).