Releases

devgrep ships static binaries through GoReleaser with checksums and Homebrew tap support.

Release process

Releases are handled by GoReleaser after tagging:

git tag v0.1.0
git push origin v0.1.0
goreleaser release --clean

Local maintainers can also run make release when configured.

Platforms

The release configuration builds static binaries for:

Linux amd64 / arm64
macOS amd64 / arm64
Windows amd64 / arm64

Artifacts include checksums. A Homebrew tap is published at devgrep/homebrew-tap.

Versioning

Semantic versioning via git tags. The binary embeds version (git describe), commit hash, and build date through Makefile LDFLAGS. devgrep version prints this metadata.

Release philosophy

Small, focused releases — CLI stability over feature sprawl
Offline-first guarantees preserved in every release
Cross-platform parity for core commands
Benchmarks and CI (GitHub Actions) gate regressions

Roadmap direction

Planned expansion stays within the indexer interface:

Additional local source indexers (Docker logs, Git history, CI logs)
Ranking improvements and shell-specific history metadata
Terminal theme polish
Performance benchmarks at scale

The project explicitly avoids cloud services, daemons, and AI wrappers. Roadmap items extend local indexing — not hosted features.

Changelog structure

Release notes should list user-visible CLI changes, indexer behavior, schema migrations, and breaking config keys. Internal refactors only matter when they affect operators or contributors.