Skip to content

Gox v0.1.0

Choose a tag to compare

@github-actions github-actions released this 13 Aug 12:26
· 252 commits to main since this release

Gox v0.1.0 is the first supported release of the Go-native formatter, linter,
and safe fixer.

Highlights

  • Deterministic, width-aware formatting for complete files and standard-input
    fragments, including compressed blocks, semicolon-separated statements,
    boolean chains, calls, literals, signatures, and function literals.
  • Comment, directive, literal, build-constraint, and source-trivia preservation
    backed by reparsing, normalized equivalence, idempotency, corpus, and fuzz
    gates.
  • Correctness-focused linting with demand-driven syntax, types, CFG, and SSA
    analysis tiers and deterministic text or versioned JSON diagnostics.
  • Safe, suggestion, and unsafe fix classes with stale-source and overlap
    rejection, full-file validation, formatter normalization, and atomic local
    replacement.
  • Cohesive fmt, lint, check, explain, version, and shell-completion
    command surfaces for editors, CI, and pre-commit workflows.

Installation

Download the archive for macOS or Linux on amd64 or arm64, verify it with the
published checksum file, and place gox on PATH. Source installation is also
available:

go install github.com/faustbrian/gox/cmd/gox@v0.1.0

Verify GitHub-hosted build provenance with:

gh attestation verify <downloaded-artifact> --repo faustbrian/gox

Compatibility And Scope

  • Supported source languages: Go 1.25 and Go 1.26.
  • Supported runtimes: macOS and Linux on amd64 and arm64.
  • Windows is unsupported.
  • Network, distributed, and userspace filesystems and forced-power-loss
    durability are outside write and fix guarantees.
  • Gox intentionally has documented formatting divergences from gofmt, gofumpt,
    and golines. Use one formatter authority per selected file and review the
    migration guide before repository-wide adoption.
  • The maintainer accepted the documented ecosystem-collision and
    trademark-risk boundary for the Gox name. This is not legal trademark
    clearance.

Every archive contains the 0BSD project license and deterministic third-party
notices. The release manifest binds all four archives to source commit
c0435d6fd70918bcdc0b1acbc9c107f9af1424fa and Go 1.26.5.

Full changelog: https://github.com/faustbrian/gox/commits/v0.1.0