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