# Install gauge with Homebrew, chocolatey, Nix, scoop, winget

Test automation tool that supports executable documentation. Version 1.6.33 via Homebrew; verified 2026-06-18.

## Install

```sh
sudo av install brew:gauge
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install gauge
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#gauge
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ga/gauge/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

### Windows

- Chocolatey (92%):

```sh
choco install gauge
```

  Evidence: Chocolatey community package catalog: gauge from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','flow-launcher'

- Scoop (92%):

```sh
scoop install main/gauge
```

  Evidence: Scoop official bucket manifest trees: bucket/gauge.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1

- winget (92%):

```sh
winget install --id Gauge.Gauge -e
```

  Evidence: Windows Package Manager source index: Gauge.Gauge from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:gauge
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/gauge>
- **Version:** 1.6.33
- **Source summary:** Test automation tool that supports executable documentation
- **Homepage:** <https://gauge.org>
- **Repository:** <https://github.com/getgauge/gauge>
- **Upstream docs:** <https://docs.gauge.org/>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/getgauge/gauge/archive/refs/tags/v1.6.33.tar.gz>
- **Last updated:** 2026-06-18T10:44:39Z
- **Generated:** 2026-07-10T07:20:53+00:00

## Executables

- gauge (cli)
- gauge (alias)

## Build dependencies

- go

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-10
- Package-manager version: 1.6.33
- Package-manager updated: 2026-06-18
- Local data: ok
- Upstream repository: https://github.com/getgauge/gauge
- Upstream latest detected: v1.6.33 (current)
## Project history and usage

Gauge is an open-source test automation framework for writing acceptance tests as executable documentation. Its central idea is to keep specifications readable in Markdown while binding steps to code in common programming languages.

### Project history

Gauge was built at ThoughtWorks to reduce the design overhead and maintenance burden of functional and acceptance test suites. The official project post introducing Gauge 1.0 describes a move from verbose test code toward reusable, refactorable steps written in business-readable text.

### Adoption history

Gauge gained adoption among teams that wanted acceptance tests without Cucumber-style BDD ceremony. The official site and docs emphasize cross-platform use, CI/CD integration, language runners, IDE support, reports, and plugins. The README notes that official sponsorship ended in 2021 and that the project moved toward community-driven maintenance.

### How it is used

Typical use begins with `gauge init` for a language such as JavaScript, Java, Python, Ruby, or C#, followed by Markdown specifications under a project and `gauge run` to execute them. Gauge supports reusable steps, concepts, data-driven tests, plugins, reports, and language-server based editor features.

### Why package nerds care

Gauge is package-manager interesting because the core CLI is only the entry point: useful installations often combine the main binary with language runners, reports, and IDE plugins. It is a good example of a Go command-line tool distributed as a package while delegating much of its runtime behavior to a plugin ecosystem.

### Timeline

- 2014: The official Gauge repository was created.
- 2018: Gauge 1.0 was presented in the official project blog.
- 2021: Official sponsorship ended, and the README described a shift to community-driven maintenance.
- 2020s: Gauge continues to document Markdown specifications, plugins, language runners, and editor integrations.

### Related projects

- Gauge is closely related to its official language runners, report plugins, IDE plugins, and Taiko, which the Gauge site presents as a companion for browser automation.

### Sources

- <https://docs.gauge.org/>
- <https://docs.gauge.org/overview.html>
- <https://gauge.org/>
- <https://gauge.org/2018/05/15/why-we-built-gauge/>
- <https://gauge.org/plugins/>
- <https://github.com/getgauge/gauge>


## Security Notes

No matching local secret-handling manifest was found for gauge. Nucleus package metadata is still published here so future coverage has a stable package URL.



## Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.


## Configuration files

- Unix: ~/.gauge/config/gauge.properties, <project_root>/env/default/default.properties, <project_root>/env/default/<language>.properties, <project_root>/manifest.json
- Windows: %APPDATA%\gauge\config\gauge.properties, <project_root>\env\default\default.properties, <project_root>\env\default\<language>.properties, <project_root>\manifest.json
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** gauge
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - gauge: normalized package name match | nixpkgs package indexes: pkgs/by-name/ga/gauge/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- Chocolatey - gauge: normalized package name match | Chocolatey community package catalog: gauge from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','flow-launcher'
- Scoop - main/gauge: normalized package name match | Scoop official bucket manifest trees: bucket/gauge.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1
- winget - Gauge.Gauge: normalized package name match | Windows Package Manager source index: Gauge.Gauge from https://cdn.winget.microsoft.com/cache/source.msix


## Related links

- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [robot-framework](https://www.automicvault.com/pkg/brew/robot-framework/) - Shares av.db curated category or tags: automation, cli, developer-tools, testing.
- [cucumber-ruby](https://www.automicvault.com/pkg/brew/cucumber-ruby/) - Shares av.db curated category or tags: bdd, cli, developer-tools, testing.
- [shellspec](https://www.automicvault.com/pkg/brew/shellspec/) - Shares av.db curated category or tags: bdd, cli, developer-tools, testing.
- [abnfgen](https://www.automicvault.com/pkg/brew/abnfgen/) - Shares av.db curated category or tags: cli, developer-tools, testing.
- [ahoy](https://www.automicvault.com/pkg/brew/ahoy/) - Shares av.db curated category or tags: automation, cli, developer-tools.
- [allure](https://www.automicvault.com/pkg/brew/allure/) - Shares av.db curated category or tags: cli, developer-tools, testing.
- [artillery](https://www.automicvault.com/pkg/brew/artillery/) - Shares av.db curated category or tags: cli, developer-tools, testing.
- [buildpulse-test-reporter](https://www.automicvault.com/pkg/brew/buildpulse-test-reporter/) - Shares av.db curated category or tags: cli, developer-tools, testing.
- [cypress](https://www.automicvault.com/pkg/npm/cypress/) - Local metadata places this package in an adjacent workflow. Shared terms: automation, cli, developer, developer-tools, executable.
- [mocha](https://www.automicvault.com/pkg/npm/mocha/) - Local metadata places this package in an adjacent workflow. Shared terms: bdd, cli, developer, developer-tools, supports.

## Combined YAML source

View the package source record on GitHub. [combined/gauge.yml](https://github.com/automic-vault/db/blob/main/combined/gauge.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated configuration and credential file locations
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph
