#Quick start

This guide takes you through one complete Web test. Start a local page, use an agent session to observe it and take one action, save the screenshot and report, then preserve the proven path as ACL. Both workflows use the same typed actions and evidence format.

#Install

On macOS or Linux:

curl -fsSL https://github.com/A3S-Lab/Test/releases/latest/download/install.sh | sh

On Windows PowerShell:

& ([scriptblock]::Create((irm 'https://github.com/A3S-Lab/Test/releases/latest/download/install.ps1')))

The installer downloads the platform CLI, verifies its SHA-256, and installs the matching Skill for detected coding agents. See Installation to select an agent or destination.

#Start a persistent Web session

Run the local product, then declare the goal and an observable success condition:

a3s-test agent start http://127.0.0.1:3000/checkout \
  --session checkout \
  --goal "Complete checkout with the fixture account" \
  --success "The confirmation heading is visible" \
  --json

Observe the current interface:

a3s-test agent observe --session checkout --interactive --json

The response contains a new observation_id and actionable semantic refs:

observation_id: 1
@e1 [button] Continue

Bind the action to that observation. Observe again after every state-changing action:

a3s-test agent click @e1 \
  --session checkout \
  --observation 1 \
  --json

#Finish with evidence

a3s-test agent screenshot screenshots/confirmation.png \
  --session checkout \
  --json

a3s-test agent finish \
  --session checkout \
  --status passed \
  --summary "Checkout completed and confirmation was observed" \
  --json

Each workspace retains an append-only record:

.a3s-test/agent-sessions/checkout/
├── session.json
├── events.jsonl
├── report.json
└── artifacts/
    └── screenshots/confirmation.png

Continue with Exploration and regression workflows, or preserve the proven path as ACL.