How do I clean up stuck Vitest processes?

The skill provides specific patterns for using pgrep and pkill to identify and terminate orphaned vitest processes that may be consuming system resources.

Does this skill support different package managers?

Yes, it provides optimized command patterns for pnpm, npm, and direct vitest CLI invocations.

Why does Vitest sometimes hang when used with Claude Code?

Vitest defaults to watch mode, which keeps the process open and waiting for file changes. This skill forces the --run flag to ensure the process exits after tests complete.

What is the recommended timeout for Vitest tests?

This skill recommends a 30,000ms (30 second) timeout for both tests and hooks to provide a safety buffer for complex operations while preventing indefinite hangs.

Vitest Safety Guard

Name: Vitest Safety Guard
Author: adbutterfield

byadbutterfield

Security & Testing

Ensures Vitest test suites run reliably by preventing hung processes, enforcing timeouts, and managing system resources.

About

The Running Vitest Safely skill provides a robust framework for executing Vitest tests within automated environments like Claude Code. It prevents common pitfalls such as infinite 'watch mode' loops and runaway processes by mandating the --run flag, configuring strict test and hook timeouts, and performing pre-flight and post-run process checks. This skill is essential for maintaining system stability and ensuring that automated test runs finish promptly without consuming excessive CPU or memory.

Key Features

Automatic watch mode disabling using the --run flag to ensure process exit
0 GitHub stars
Strict timeout enforcement for tests and hooks to prevent infinite hangs
Fail-fast implementation with --bail flags to conserve resources on failure
Pre-flight process monitoring to detect and manage existing Vitest instances
Post-run verification and cleanup patterns for zombie process management

Use Cases

Executing automated unit and integration tests within a Claude Code session
Standardizing Vitest execution flags across a development team to avoid CI/CD hangs
Managing test suites in resource-constrained environments to prevent CPU spikes

About

Key Features

Automatic watch mode disabling using the --run flag to ensure process exit
0 GitHub stars
Strict timeout enforcement for tests and hooks to prevent infinite hangs
Fail-fast implementation with --bail flags to conserve resources on failure
Pre-flight process monitoring to detect and manage existing Vitest instances
Post-run verification and cleanup patterns for zombie process management

Use Cases

Executing automated unit and integration tests within a Claude Code session
Standardizing Vitest execution flags across a development team to avoid CI/CD hangs
Managing test suites in resource-constrained environments to prevent CPU spikes