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 workflow

Agents can discover the full flow from ta --help. The usual path is:

$
ta auth
$
echo '{"name":"Example","url":"https://example.com","projectType":"web"}' | ta projects create --json
$
ta projects list --json
$
echo '{"category":"site_structure","title":"Auth route","content":"Login is at /login","importance":"high"}' | ta memories create --project <projectId> --json
$
ta memories delete <memoryId> --project <projectId> --json
$
echo '{"title":"Login flow","steps":[{"title":"Navigate to /login","type":"act"},{"title":"Dashboard loads","type":"assert"}]}' | ta tests create --project <projectId> --json
$
ta tests run <testId> --remote --wait --json

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 Profile → API Keys.

For API key troubleshooting and Bearer token examples, see 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