Installation¶

teststop ships as a single, zero-dependency binary. No runtime, no config files, no daemon.

Prerequisites¶

teststop shells out to an AI CLI — it does not use an API SDK or require API keys.

You need one of the following on your PATH:

Verify your AI CLI works:

echo "Hello" | claude -p "Respond in one word"

Install Methods¶

go install github.com/shaifulshabuj/teststop/cmd/teststop@latest

export PATH="$PATH:$(go env GOPATH)/bin"

curl -L https://github.com/shaifulshabuj/teststop/releases/latest/download/teststop_Darwin_arm64.tar.gz \
  | tar xz teststop
sudo mv teststop /usr/local/bin/

curl -L https://github.com/shaifulshabuj/teststop/releases/latest/download/teststop_Darwin_x86_64.tar.gz \
  | tar xz teststop
sudo mv teststop /usr/local/bin/

curl -L https://github.com/shaifulshabuj/teststop/releases/latest/download/teststop_Linux_x86_64.tar.gz \
  | tar xz teststop
sudo mv teststop /usr/local/bin/

curl -L https://github.com/shaifulshabuj/teststop/releases/latest/download/teststop_Linux_arm64.tar.gz \
  | tar xz teststop
sudo mv teststop /usr/local/bin/

git clone https://github.com/shaifulshabuj/teststop
cd teststop
go build -o teststop ./cmd/teststop
sudo mv teststop /usr/local/bin/

Verify Installation¶

teststop --version

teststop version v0.1.0

Sandbox (Optional — macOS only)¶

teststop can run the AI inside an isolated Apple Container VM for extra security. This is optional — without it, teststop runs the AI CLI directly.

brew install container
container system start

When the container daemon is running, teststop automatically uses it. To disable sandbox regardless: TESTSTOP_SANDBOX=none teststop run

See Sandbox Isolation for details.

Next Step¶

Run your first test