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

0•

安全与测试

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

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.

主要功能

01Automatic watch mode disabling using the --run flag to ensure process exit

020 GitHub stars

03Strict timeout enforcement for tests and hooks to prevent infinite hangs

04Fail-fast implementation with --bail flags to conserve resources on failure

05Pre-flight process monitoring to detect and manage existing Vitest instances

06Post-run verification and cleanup patterns for zombie process management

使用场景

01Executing automated unit and integration tests within a Claude Code session

02Standardizing Vitest execution flags across a development team to avoid CI/CD hangs

03Managing test suites in resource-constrained environments to prevent CPU spikes

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add adbutterfield/coding-agent-plugins running-vitest-safely

For use in Claude.ai and ChatGPT

Download Skill