oxygen: Command for Claude Code

Run agentic browser tests

Wraps pnpm test:agentic with HEADED=1 DEBUG=1 so the dev sees the browser and the per-iteration LLM reasoning.

The runner auto-spawns the right oxy backend based on each flow's settings.backend_mode (cloud, the default, → enterprise mode: oxy start --enterprise, oxy seed of demo_project/, and a dev-login session as [email protected], all on port 3000; local → the legacy oxy start --local --enterprise). No port-probing or pre-start dance needed.

$ARGUMENTS is one or more positional flow-name substring filters (OR-combined). A flow matches if its filename contains ANY of the listed substrings. Empty $ARGUMENTS = all flows.

This command must be run from the root of an oxy-hq/oxygen-internal checkout.

Steps

1. Sanity-check the working directory

test -f web-app/tests/agentic/README.md && test -f json-schemas/flow-test.json

If either path is missing, exit and tell the dev: "This command must be run from the root of an oxy-hq/oxygen-internal checkout where the agentic browser-test layer is present (see web-app/tests/agentic/README.md)."

2. Confirm ANTHROPIC_API_KEY is set

The runner exits 2 with ERROR: ANTHROPIC_API_KEY is required if it's unset (see runner/cli.ts). Fail loudly before spawning anything:

if [ -z "${ANTHROPIC_API_KEY:-}" ]; then
  echo "Set ANTHROPIC_API_KEY first: export it, or add to web-app/.env.local."
  exit 2
fi

3. Validate Docker is up (the runner needs it for Postgres)

docker info >/dev/null 2>&1 || {
  echo "Docker Desktop must be running — \`oxy start\` brings up Postgres in a container."
  exit 2
}

4. Run the tests

From web-app/:

cd web-app
HEADED=1 DEBUG=1 pnpm test:agentic $ARGUMENTS

The runner reads each loaded flow's settings.backend_mode (default cloud, enterprise mode), spawns the right oxy start … invocation and seeds demo_project/ itself. If a backend is already healthy at the resolved URL, the runner uses it as-is: no respawn and no seed — a just up stack has examples/ as its Demo workspace and does not allow [email protected] to sign in (see the runner README, "Run").