tomevault-io 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
Hand off files to test-writer subagents. They determine testability and write tests.
| Files | Subagents |
|---|---|
| 1-3 | 1 |
| 4-8 | 2-3 |
| 9+ | 3-5 |
// Task tool
{
subagent_type: "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 using agent-browser CLI. See /browser skill for full API.
# Determine dev server URL from package.json or running processes
agent-browser open {url} # e.g., http://localhost:5173
agent-browser wait 3000
agent-browser screenshot .otto/test-screenshots/page.png
agent-browser snapshot -i
# Interact and verify
agent-browser click @e3
agent-browser snapshot -i
agent-browser close
rm -rf .otto/test-screenshots
Electron Mode
Visual verification for Electron/VS Code apps via CDP.
# Detect: engines.vscode in package.json → VS Code extension
# Detect: electron in dependencies → Electron app
# Build first
npm run compile
# Launch (VS Code extension example)
code --extensionDevelopmentPath=./ --disable-extensions \
--remote-debugging-port=9333 . &
APP_PID=$!
sleep 8
# Connect and verify
agent-browser connect 9333
agent-browser snapshot -i
agent-browser screenshot .otto/test-screenshots/electron.png
# Check webviews if applicable
agent-browser tab
agent-browser tab 1
agent-browser snapshot -i
# Cleanup
agent-browser close
kill $APP_PID
rm -rf .otto/test-screenshots
All Mode
- Run Mode (lint, type check, test)
- Auto-detect: web → Browser Mode, Electron/VS Code → Electron Mode
- Report results
Converted and distributed by TomeVault — claim your Tome and manage your conversions.