Skip to content

tester-army/testerarmy

v1.0.0MIT

TesterArmy runs agents that click through your web and mobile app the way a real user would, on every pull request. Create tests in plain language, start runs, and read what broke without leaving your editor.

GitHubOpen Website

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 through JSON output.
  • Feed concrete validation back to coding agents.

Start here:

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 --json
ta tests list --project <projectId> --json
ta 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.

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 Claude Code plugin that installs the MCP server and the testerarmy-cli skill together: run /plugin marketplace add tester-army/cli, then /plugin install testerarmy@testerarmy-agent-skills.

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> --json
ta 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