Skip to main content

Homebrew (macOS / Linux)

hitspec is published as a Homebrew cask in the abdul-hamid-achik/tap tap:
This installs the latest release and makes the hitspec command available in your shell.

Go Install

If you have Go installed:
Requires Go 1.25 or later. The binary will be placed in your $GOPATH/bin directory — make sure it’s in your PATH.

Binary Download

Pre-built archives for every platform are attached to each GitHub Release. Assets are named:
where <os> is darwin, linux, or windows and <arch> is amd64 or arm64.
Download the archive for your platform from the Releases page, then extract and install it. For example, on Apple Silicon macOS:
Homebrew (brew install --cask abdul-hamid-achik/tap/hitspec) and go install keep hitspec up to date automatically — prefer them over manual downloads unless you need a specific archived version.

Build from Source

To build hitspec yourself — to contribute, or to get an unreleased change — clone the repo and build the CLI. The module is github.com/abdul-hamid-achik/hitspec and the CLI entry point is apps/cli.
1

Prerequisites

  • Go 1.25+ (go version)
  • Task — the task runner used for every dev command (optional, but recommended)
  • glyph — only needed to run the studio end-to-end specs (task e2e)
2

Clone and build

task build stamps the binary with the version and build time. The result is ./bin/hitspec.
3

Install to your PATH (optional)

4

Run the checks

Run task (or task --list) to see every available command, including task studio:dev, task serve:dev, and task docs:dev (live Mintlify docs).

Verify Installation

You should see the installed version number. If the command is not found, make sure the binary location is in your PATH.

Updating

Last modified on July 18, 2026