> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://tester.army/docs/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://tester.army/_mcp/server.

# Quick Start

#### With Agent

Let your coding agent set up TesterArmy for you using the [CLI](/cli).

### 1. Create an account

Sign up at [tester.army](https://tester.army/sign-in).

### 2. Install and authenticate the CLI

```bash
npm install -g testerarmy
ta agent init
ta auth
ta status --json
```

Generate a key in the [API Keys dashboard](https://tester.army/dashboard/profile/api-keys) and paste it when prompted. The CLI stores it locally for future commands.

### 3. Prompt your agent

```txt
Use TesterArmy CLI (`ta`) to set up QA for this project. Start with
`ta docs --json`, create a project, create a saved test, run it, and report the
commands, run ID, result, and artifacts. Use `--json` for automation.
```

The agent will create the project, draft tests, and execute them - without you leaving your editor. See [Agentic Usage](/cli/agentic-usage) for the full workflow.

#### Manual

### 1. Create an account

Sign up at [tester.army](https://tester.army/sign-in).

### 2. Create a project

Click **New Project** in the dashboard sidebar. Enter your app name and target URL (e.g., `https://staging.myapp.com`). Click **Create**.

![Creating a new project](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/testerarmy-subpath.docs.buildwithfern.com/1fa35046f7f9b91d9b210bb58359fa92e026cb05530faa8595142cafa4ebb692/docs/assets/docs/create-new-project.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260817%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260817T151230Z&X-Amz-Expires=604800&X-Amz-Signature=e4570fe557e7bb5507b334674ea55947c0e440f1addeea529290a44c9b5c958b&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

### 3. Create a test

Click on create a new test and type-in your prompt. This will generate a test plan that you can tweak. After approving the plan, click **Run**.

![Creating a new test](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/testerarmy-subpath.docs.buildwithfern.com/a556b1a080efabf2d7f577c877625c41651fb6d060be752c0ab464cdbb129c65/docs/assets/docs/create-new-test.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260817%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260817T151230Z&X-Amz-Expires=604800&X-Amz-Signature=7da283ba60f2d698527a5e28cc156f9ac8a89b5cb9a34f5322c01c8e2859c3fa&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

This will generate a step-by-step test plan that you can tweak before running:

![TesterArmy step editor](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/testerarmy-subpath.docs.buildwithfern.com/a7f104719ab1da1d171821c15cf00d4646b32ae51fce481da2b15625fb4046cd/docs/assets/docs/step-definition.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260817%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260817T151230Z&X-Amz-Expires=604800&X-Amz-Signature=788831b33149e61923badf102bdd56b91f06c56b8f2a92b56297509f418de4fd&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

After reviewing the steps, click **Run**.

![TesterArmy test run](https://fdr-prod-docs-files-public.s3.us-east-1.amazonaws.com/testerarmy-subpath.docs.buildwithfern.com/d4997c336dfdbdb4e4930d1db588b9d6a2bfd9a29dec75d1bfa337686ff72473/docs/assets/docs/test-run.png?X-Amz-Algorithm=AWS4-HMAC-SHA256&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD&X-Amz-Credential=AKIA6KXJSKKNFOCF7G4B%2F20260817%2Fus-east-1%2Fs3%2Faws4_request&X-Amz-Date=20260817T151230Z&X-Amz-Expires=604800&X-Amz-Signature=506a8777f53be819c2b939775e2862c07e7233bf4cdb8921d569c1a9e2dd089d&X-Amz-SignedHeaders=host&x-amz-checksum-mode=ENABLED&x-id=GetObject)

This will open a cloud based browser and our agent will execute the steps and give you feedback if something goes wrong.

<b>
  Congrats! You successfully created and executed your very first test!
</b>

Testing is all about consistency, you should set up [Production Monitoring](/run/production-monitoring) or [PR Testing](/run/pull-request-testing) to guarantee everything keeps working.

## Next steps

#### [PR Testing](/run/pull-request-testing)

Automatically test every pull request on deploy.

#### [Production Monitoring](/run/production-monitoring)

Monitor your production with recurring test runs.