Test

Arguments: $ARGUMENTS

| Command | Behavior | |---------|----------| | run | Lint + type check + run tests | | write | Generate tests, then run pipeline | | browser | Visual verification (web apps) | | electron | Visual verification (Electron/VS Code apps) | | all | run + browser/electron combined |

Scope (optional, default: branch):

| Scope | Command | |-------|---------| | branch | git diff main...HEAD --name-only | | staged | git diff --cached --name-only |

---

Run Mode

1. Detect Tools

| Config | Tool | Command | |--------|------|---------| | package.json + vitest | Vitest | npx vitest run | | package.json + jest | Jest | npx jest | | package.json + "test" | npm | npm test | | pyproject.toml | pytest | pytest | | Cargo.toml | cargo | cargo test | | go.mod | go | go test ./... | | .eslintrc* / eslint.config.* | ESLint | npx eslint . | | biome.json | Biome | npx biome check . | | tsconfig.json | TypeScript | npx tsc --noEmit |

2. Setup (if missing)

# JS/TS test runner
npm install -D vitest

# JS/TS linter
npm install -D eslint @eslint/js

# JS/TS types
npm install -D typescript && npx tsc --init

# Python
pip install pytest ruff mypy

3. Run Pipeline

# 1. Lint
npx eslint . --fix  # or: npx biome check . --write

# 2. Type check
npx tsc --noEmit    # or: mypy .

# 3. Test
npx vitest run      # or: pytest, cargo test, go test ./...

Fix errors, re-run until all pass.

---

Write Mode

1. Get Changed Files

git diff main...HEAD --name-only  # branch scope
git diff --cached --name-only     # staged scope

Filter to source files (exclude tests, configs, docs).

2. Launch Test Writers

Delegate files to the test-writer subagent (persona in agents/test-writer.md). It determines testability and writes tests.

| Files | Subagents | |-------|-----------| | 1-3 | 1 | | 4-8 | 2-3 | | 9+ | 3-5 |

spawn subagent(role="test-writer", prompt="Write tests for: [file list]. Runner: vitest. Convention: *.test.ts")

3. Run Pipeline

Same as Run Mode step 3.

---

Browser Mode

Visual verification for web apps. The legacy standalone UI automation workflow has been removed; use the host environment's available browser automation tool directly.

1. Detect dev server URL from package.json or running processes
2. Open the URL, capture an accessibility/DOM snapshot, interact through semantic selectors, and take screenshots
3. Screenshots go to .otto/test-screenshots/
4. Cleanup any browser session/tool process and remove .otto/test-screenshots when no longer needed

---

Electron Mode

Visual verification for Electron/VS Code apps. The legacy standalone UI automation workflow has been removed; use the app's project-specific harness first when available, otherwise use the host environment's available browser automation tool directly.

1. Detect app type: engines.vscode in package.json → VS Code extension, electron in dependencies → Electron app
2. Build first: npm run compile
3. Launch with CDP/automation hooks, connect, inspect snapshots/webviews, interact through semantic selectors, and take screenshots
4. Screenshots go to .otto/test-screenshots/
5. Cleanup browser/app processes and remove .otto/test-screenshots when no longer needed

---

All Mode

1. Run Mode (lint, type check, test)
2. Auto-detect: web → Browser Mode, Electron/VS Code → Electron Mode
3. Report results

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: brsbl
• Source: brsbl/ottonomous
• License: MIT

Install and usage instructions live in the source repository linked above.