# Install vgt with Homebrew

Visualising Go Tests. Version 1.0.1 via Homebrew; verified 2026-07-26.

## Install

```sh
sudo av install brew:vgt
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install vgt
```

  Evidence: local Homebrew formula metadata

## Package facts

- **Package key:** brew:vgt
- **Package manager:** Homebrew
- **Version:** 1.0.1
- **Source summary:** Visualising Go Tests
- **Homepage:** <https://threedots.tech/post/go-test-parallelism/>
- **Repository:** <https://github.com/roblaszczak/vgt>
- **Last updated:** 2026-07-26T00:30:32+02:00
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- vgt (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 1.0.1
## Project history and usage

vgt is a small Go developer tool for turning `go test -json` output into a browser visualization. Its niche is test-suite diagnosis: it helps Go developers see test parallelism, slow tests, and the actual schedule produced by the Go test runner.

### Project history

The public GitHub repository was created on 2024-09-21 by Robert Laszczak. The project was introduced alongside a Three Dots Labs article about why adding CPU cores alone does not necessarily speed up Go test suites, and the README describes vgt as a tool for visualising Go test results in a browser.

### How it is used

The typical workflow is deliberately Unix-like: run `go test -json ./...` and pipe the event stream into `vgt`, or save the JSON output and replay it later. vgt then opens a browser view of the test run, with flags for reading from a file, printing HTML, preserving browser state, and filtering very short durations.

### Why package nerds care

vgt is significant mainly as a focused companion to Go's standard JSON test output. Instead of replacing `go test`, it consumes the standard event stream and makes timing and parallelism visible, which is useful when tuning `t.Parallel`, package-level concurrency, and slow integration-test suites.

### Timeline

- 2024-09-21: GitHub repository created.
- 2024-10-16: v1.0.0 release published.
- 2025-12-15: v1.0.1 release published.

### Sources

- <https://api.github.com/repos/roblaszczak/vgt>
- <https://api.github.com/repos/roblaszczak/vgt/releases>
- <https://github.com/roblaszczak/vgt>
- <https://threedots.tech/post/go-test-parallelism/>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals


## Combined YAML source

View the package source record on GitHub. [combined/vgt.yml](https://github.com/mxcl/pkgdb/blob/main/combined/vgt.yml)


## Sources

- pkg.so package database
- Geiger risk classifier
- curated package history
- pkgdb category and tag curation
- cross-ecosystem install command graph