TesterArmy

[TesterArmy CLI]

Quickstart | Docs | Platform | API Keys | Skills | MCP | Examples

[npm version] [npm downloads] [MIT license]

Agents that test your app like real users.

TesterArmy CLI (testerarmy / ta) manages QA coverage in the TesterArmy dashboard and queues runs that execute in TesterArmy cloud.

• Create and organize saved tests with plain-language steps.
• Run browser and mobile checks against saved environments.
• Wait for results and inspect run transcripts, recordings, and JUnit reports.
• Schedule groups, explore with discovery runs, and triage the issues they find.
• Feed concrete validation back to coding agents.

Start here:

• Docs: tester.army/docs
• Platform: tester.army
• API keys: tester.army/dashboard/profile/api-keys

https://github.com/user-attachments/assets/f7524c3f-018e-46eb-9bae-cb69335fda64

Quickstart

Install globally:

npm install -g testerarmy

Then create API key:

tester.army/dashboard/profile/api-keys

Authenticate (pick one):

ta auth

Or run without install:

npx testerarmy --help

Find a project and its saved tests, then wait for a cloud run:

ta projects list --jsonta tests list --project <projectId> --jsonta tests run <testId> --wait --json

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>.

Skill Installation

Use skills CLI install:

npx skills add tester-army/cli

MCP server and plugins

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. MCP and the CLI cover the same features; pick whichever your agent drives more easily.

Claude Code:

claude mcp add --transport http testerarmy https://tester.army/mcp

Codex:

codex mcp add testerarmy --url https://tester.army/mcp

Or add it to ~/.codex/config.toml and run codex mcp login testerarmy:

[mcp_servers.testerarmy]url = "https://tester.army/mcp"

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:

{  "mcpServers": {    "testerarmy": {      "url": "https://tester.army/mcp"    }  }}

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:

codex plugin marketplace add tester-army/clicodex plugin add testerarmy@testerarmy-agent-skills

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

Examples

Use the markdown scenarios in examples/ as authoring references when creating saved dashboard tests with ta tests create.

• examples/TESTER.md
• examples/tests/01-landing-page.md
• examples/tests/02-auth-smoke.md
• examples/tests/03-project-create.md
• examples/prompts/ad-hoc-regression.md

Run a saved smoke group:

ta groups list --project <projectId> --jsonta tests run --group <groupId> --project <projectId> --wait --json

Contributing

PRs welcome, especially for:

• improving skill quality and references
• better issue templates and triage process
• better real-world test examples

License

MIT