Installation

Prerequisites

• Go 1.21 or later
• goimports (optional but recommended — used to sort imports in generated files)

go install golang.org/x/tools/cmd/goimports@latest

Install via go install

go install github.com/padiazg/go-testgen@latest

The binary is placed in $GOPATH/bin (or $GOBIN if set). Make sure that directory is in your PATH.

Install via Homebrew (macOS and Linux)

brew tap padiazg/go-testgen
brew install go-testgen

Homebrew places the binary in its own prefix and adds it to PATH automatically. To upgrade later:

brew upgrade go-testgen

The tap repository is at github.com/padiazg/homebrew-go-testgen.

Build from Source

git clone https://github.com/padiazg/go-testgen.git
cd go-testgen
make build    # outputs to bin/go-testgen
make install  # installs to $GOPATH/bin

Verify Installation

go-testgen version

AI Agent Skills

Install go-testgen AI agent skills to guide coding assistants in generating test cases:

curl -fsSL https://raw.githubusercontent.com/padiazg/go-testgen/main/scripts/install.sh | bash

Installs closure-check-tests and gen-test-cases skills into ~/.agents/skills/. See AI Agent Skills for usage details.

Optional: Project Configuration File

Create .go-testgen.yaml in your project root to control generation behavior. See Configuration for all options.

receiver_var_name: "s"
result_var_name: "r"
use_testify: true
add_todo_cases: true
number_of_todos: 2