tomevault-io Context-Efficient Test Runner
Runs vitest with minimal context consumption. Passing tests show as a single ✓ line. Failing tests show the test name + first line of error. This saves 90%+ of context tokens vs raw vitest output.
Based on HumanLayer's backpressure pattern: swallow passing output, dump failures.
Usage
ALWAYS use this skill instead of running vitest directly. Raw vitest output wastes context.
Run all integration tests
.claude/skills/test-quiet/scripts/run.sh
Run specific tests
.claude/skills/test-quiet/scripts/run.sh test/integration/core.test.ts
.claude/skills/test-quiet/scripts/run.sh test/integration/
Detect flaky tests
Re-runs failing tests multiple times to distinguish flaky from consistent failures:
.claude/skills/test-quiet/scripts/run.sh --flaky
.claude/skills/test-quiet/scripts/run.sh --flaky --runs 5
Options
| Flag | Description |
|---|---|
--flaky |
Re-run failing tests to detect flakiness |
--runs N |
Number of re-runs for flaky detection (default: 3) |
[path] |
Test file or directory (default: test/integration/) |
Output Format
tx test-quiet — hide passing, show failures
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✓ test/integration/core.test.ts (82 tests)
✓ test/integration/cycle-scan.test.ts (15 tests)
✗ test/integration/cli-graph.test.ts (0 passed, 51 failed)
FAIL: CLI graph:link creates an anchor...
SyntaxError: JSON Parse error: Unexpected EOF
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
1/3 files failed — 51/148 tests failed, 0 skipped (5s)
After Running
- If all pass: you're done, move on
- If failures exist: read the failing test file and the error message to understand what's broken
- If
--flakyshows flaky tests: investigate timer/async issues (see test-diagnostics skill) - Do NOT re-run the full suite to "double check" — trust the results
Converted and distributed by TomeVault — claim your Tome and manage your conversions.