cleanup-chrome

Force-terminate orphaned chromedriver and headless Chrome processes on Windows.

2|1|Updated Nov 7, 2025
One-click install
npx skills add https://github.com/is-ivanov/rpm-ddd --skill cleanup-chrome
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: cleanup-chrome
Source: https://github.com/is-ivanov/rpm-ddd/tree/main/.opencode/skills/cleanup-chrome
Command: npx skills add https://github.com/is-ivanov/rpm-ddd --skill cleanup-chrome

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill clears orphaned chromedriver and headless Chrome processes that remain after failed or interrupted Selenium runs, preventing resource exhaustion, sluggish machines, and repeated browser automation failures.

Core Features & Use Cases

  • Process Cleanup: Counts and force-terminates leftover chromedriver.exe and chrome.exe processes from test automation runs.
  • Test Recovery: Helps recover from mass Selenium failures such as Connection reset errors and TimeoutException issues tied to Chrome DevTools connections.
  • Workspace Reset: Removes locked frontend test output so acceptance test runs can start cleanly after a crash or forced stop.
  • Use Case: When frontend acceptance tests suddenly start failing across the board after a previous interrupted run, use this Skill to clean stale browser processes before rerunning the suite.

Quick Start

Ask the AI to use the cleanup-chrome skill to count and kill orphaned Chrome and chromedriver processes before rerunning your Selenium or frontend acceptance tests.

Frequently Asked Questions about cleanup-chrome

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I kill orphaned chromedriver and chrome.exe processes breaking Selenium on Windows?

To kill orphaned chromedriver and chrome.exe processes on Windows, you need a cleanup routine that counts active browser automation processes and force-terminates them repeatedly until clear. This restores Selenium stability by eliminating stale processes causing timeouts.

Why do Selenium frontend acceptance tests suddenly fail with TimeoutException after an interrupted run?

Selenium frontend acceptance tests fail with TimeoutException or Connection reset errors after an interrupted run because orphaned chromedriver and headless Chrome processes remain active, locking test artifacts and breaking Chrome DevTools connections. Clearing these stale processes resolves the mass failures.

What is the best way to clean up locked frontend test output directories after a Selenium crash?

The best way to clean up locked frontend test output directories after a Selenium crash is to first force-terminate leftover chromedriver.exe and chrome.exe processes, then remove the locked test output directories so acceptance test runs can start cleanly.

Does cleaning up stale Chrome processes close my active browser sessions?

Yes, cleaning up stale Chrome processes may close active browser sessions. The cleanup routine warns about closing active Chrome sessions before it counts and force-terminates chrome.exe and chromedriver.exe processes to ensure all orphaned browser automation tasks are cleared.

Can I reset my Windows test environment for browser automation without manually ending tasks in Task Manager?

Yes, you can reset your Windows test environment for browser automation without Task Manager by automating the process. A cleanup script counts chromedriver.exe and chrome.exe instances, force-terminates them, and removes locked test output, providing a full workspace reset.

What limitations should I expect when force-terminating headless Chrome processes to fix test failures?

A key limitation when force-terminating headless Chrome processes is the risk of closing active, unsaved Chrome browser sessions. Additionally, the process targets Windows chrome.exe and chromedriver.exe specifically, requiring repeated termination cycles to ensure no stale browser automation tasks remain.