The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the TesterArmy listing page.
Quickstart | Docs | Platform | API Keys | Skills | MCP | Examples
TesterArmy CLI (testerarmy / ta) manages QA coverage in the TesterArmy dashboard
and queues runs that execute in TesterArmy cloud.
Start here:
https://github.com/user-attachments/assets/f7524c3f-018e-46eb-9bae-cb69335fda64
Install globally:
Then create API key:
tester.army/dashboard/profile/api-keys
Authenticate (pick one):
Or run without install:
Find a project and its saved tests, then wait for a cloud run:
Use IDs returned by the list commands. Without --wait, a successful command
only confirms that the run was queued. To validate development changes, save a
cloud-reachable preview or tunnel URL as a project environment and select it
with --env <nameOrSlug>.
Use skills CLI install:
TesterArmy also runs as a hosted MCP server at https://tester.army/mcp (Streamable HTTP). It signs you in with your TesterArmy account through OAuth, so there is no API key to create or paste.
Claude Code:
Codex:
Or add it to ~/.codex/config.toml and run codex mcp login testerarmy:
Cursor: open Customize and search for testerarmy, or click Add to Cursor on the marketplace listing. If the plugin is not listed yet, add the server by hand to ~/.cursor/mcp.json:
This repo is also a plugin that installs the MCP server and the testerarmy-cli skill together.
Claude Code: run /plugin marketplace add tester-army/cli, then /plugin install testerarmy@testerarmy-agent-skills.
Codex: the repo is a plugin marketplace too, so until TesterArmy appears in the Plugins Directory you can add it from here:
The plugin registers the hosted server for you; sign in once with codex mcp login testerarmy, or accept the sign-in prompt the ChatGPT app shows at install. In the ChatGPT desktop app, open this repository in Codex and the marketplace appears as a source in the Plugins tab.
Full reference for the server and its tools: https://docs.tester.army/cli/mcp
Use the markdown scenarios in examples/ as authoring
references when creating saved dashboard tests with ta tests create.
examples/TESTER.mdexamples/tests/01-landing-page.mdexamples/tests/02-auth-smoke.mdexamples/tests/03-project-create.mdexamples/prompts/ad-hoc-regression.mdRun a saved smoke group:
PRs welcome, especially for:
MIT