TesterArmy

快速入门 | 文档 | 平台 | API 密钥 | 技能 | MCP | 示例

像真实用户一样测试应用的 Agent。

TesterArmy CLI（testerarmy / ta）可在 TesterArmy 控制面板中管理 QA 覆盖范围， 并将运行任务加入队列，在 TesterArmy 云端执行。

• 使用自然语言步骤创建和整理已保存的测试。
• 针对已保存的环境运行浏览器和移动端检查。
• 等待结果，并通过 JSON 输出查看运行记录。
• 为编码 Agent 提供具体的验证反馈。

从这里开始：

• 文档：tester.army/docs
• 平台：tester.army
• API 密钥： tester.army/dashboard/profile/api-keys

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

快速入门

全局安装：

npm install -g testerarmy

然后创建 API 密钥：

tester.army/dashboard/profile/api-keys

进行身份验证（任选一种方式）：

ta auth

或者无需安装即可运行：

npx testerarmy --help

查找项目及其已保存的测试，然后等待云端运行：

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

使用列表命令返回的 ID。不带 --wait 时，命令成功只表示运行任务已加入队列。若要验证开发更改，请将云端可访问的预览或隧道 URL 保存为项目环境，并使用 --env <nameOrSlug> 选择该环境。

技能安装

使用 skills CLI 安装：

npx skills add tester-army/cli

MCP 服务和插件

TesterArmy 也以托管 MCP 服务的形式运行，地址为 https://tester.army/mcp（Streamable HTTP）。它通过 OAuth 使用你的 TesterArmy 账户登录，因此无需创建或粘贴 API 密钥。

Claude Code：

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

Codex：

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

或者将其添加到 ~/.codex/config.toml，然后运行 codex mcp login testerarmy：

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

Cursor：打开 Customize 并搜索 testerarmy，或点击市场列表中的 Add to Cursor。如果插件尚未列出，请手动将服务添加到 ~/.cursor/mcp.json：

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

此仓库也是一个插件，可同时安装 MCP 服务和 testerarmy-cli 技能。

Claude Code：运行 /plugin marketplace add tester-army/cli，然后运行 /plugin install testerarmy@testerarmy-agent-skills。

Codex：此仓库也是一个插件市场，因此在 Plugins Directory 中出现 TesterArmy 之前，你可以从这里添加：

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

此插件会为你注册托管服务；只需使用 codex mcp login testerarmy 登录一次，或者接受 ChatGPT 应用在安装时显示的登录提示。在 ChatGPT 桌面应用中，于 Codex 打开此仓库，该市场就会作为来源显示在 Plugins 标签页中。

服务及其工具的完整参考文档：https://docs.tester.army/cli/mcp

示例

使用 examples/ 中的 Markdown 场景作为编写参考，通过 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

运行已保存的冒烟测试组：

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

参与贡献

欢迎提交 PR，尤其是：

• 提升技能质量并改进参考资料
• 改进问题模板和分流流程
• 增加更贴近实际场景的测试示例

许可证

MIT