Getting Started

testerarmy (alias ta) is an agent-first QA runner. It works standalone for interactive use or as a skill for coding agents like Claude Code, Codex, and OpenCode.

Your coding agent spawns testing agents to validate changes - keeping the feedback loop tight without polluting main agent context.

Install

$
npm install -g testerarmy

Or use without installing:

$
npx testerarmy --help

Both testerarmy and ta map to the same CLI.

Agent skill (recommended)

If you use a coding agent, install the official skill for tighter integration:

$
npx skills add tester-army/cli

This gives your agent structured instructions for running tests, interpreting results, and iterating on failures.

Repository: github.com/tester-army/cli

Authenticate

Run ta auth and paste your API key when prompted:

$
ta auth

Get your key from the TesterArmy dashboard under Team Settings → API Keys.

You can also pass the key directly:

$
ta auth --api-key YOUR_KEY

Or set it as an environment variable (useful for CI):

$
export TESTERARMY_API_KEY="YOUR_KEY"

Verify

$
ta status

Use --json for machine-readable output:

$
ta status --json

Sign out

$
ta signout
$
# or
$
ta logout

Next steps