test

A command for running unit, integration, and end-to-end tests, which test a complete user flow, with optional coverage reports. It can also monitor tests continuously and analyze failures.

In plain words
What is it for?
Use it to run selected tests or all tests, generate coverage information, watch tests during development, debug failures, or perform browser-based end-to-end testing.
Why use it?
It helps developers discover the available tests, run the appropriate ones, measure which code is covered, and understand failures.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/superclaude-org/superclaude_framework/test
Clone the repo
git clone --depth 1 https://github.com/SuperClaude-Org/SuperClaude_Framework
Per session 11 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 640 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00011 $0.00640
Opus 5 $0.00005 $0.00320
Sonnet 5 $0.00002 $0.00128
Haiku 4.5 $0.00001 $0.00064

Measured 3d ago against content hash 232466ff1f5f, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

test scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

Copies of this mod

1 near-identical copy found in the catalogue:

  • test — 95% identical, 12 lines differ
plugins/superclaude/commands/test.md · 93 lines

How it starts

The opening of the file, as written. The whole thing — 93 lines — stays where its author put it; the contents beside it link to each section on GitHub.

/sc:test - Testing and Quality Assurance

Triggers

  • Test execution requests for unit, integration, or e2e tests
  • Coverage analysis and quality gate validation needs
  • Continuous testing and watch mode scenarios
  • Test failure analysis and debugging requirements

Usage

/sc:test [target] [--type unit|integration|e2e|all] [--coverage] [--watch] [--fix]

Behavioral Flow

  1. Discover: Categorize available tests using runner patterns and conventions
  2. Configure: Set up appropriate test environment and execution parameters
  3. Execute: Run tests with monitoring and real-time progress tracking
  4. Analyze: Generate coverage reports and failure diagnostics
  5. Report: Provide actionable recommendations and quality metrics

Key behaviors:

  • Auto-detect test framework and configuration
  • Generate comprehensive coverage reports with metrics
  • Activate Playwright MCP for e2e browser testing
  • Provide intelligent test failure analysis
  • Support continuous watch mode for development

MCP Integration

  • Playwright MCP: Auto-activated for --type e2e browser testing
  • QA Specialist Persona: Activated for test analysis and quality assessment
  • Enhanced Capabilities: Cross-browser testing, visual validation, performance metrics

Tool Coordination

  • Bash: Test runner execution and environment management
  • Glob: Test discovery and file pattern matching
  • Grep: Result parsing and failure analysis
  • Write: Coverage reports and test summaries

Key Patterns

  • Test Discovery: Pattern-based categorization → appropriate runner selection
  • Coverage Analysis: Execution metrics → comprehensive coverage reporting
  • E2E Testing: Browser automation → cross-platform validation
  • Watch Mode: File monitoring → continuous test execution

Examples

Basic Test Execution

/sc:test
# Discovers and runs all tests with standard configuration
# Generates pass/fail summary and basic coverage

Targeted Coverage Analysis

/sc:test src/components --type unit --coverage
# Unit tests for specific directory with detailed coverage metrics

Read the full file on GitHub · 93 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 93 lines · 11 tokens per session scan A 232466ff1f5f

Subscribe to this mod's changes

test is a command published in the GitHub repository SuperClaude-Org/SuperClaude_Framework (23,856 stars, last pushed 12d ago), licensed MIT. It adds 11 tokens to every session and 640 once invoked, about $0.0001 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.