tiagonrodrigues

Agent Reaper — Testing skill for Claude Code

Testing community

Kill the zombie processes your AI coding agents leave behind.

How to install Agent Reaper

This entry records only its repository, not the path inside it, so there is no exact command to give. Open tiagonrodrigues/agent-reaper and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Agent Reaper does

Kill the zombie processes your AI coding agents leave behind. A safe-by-design macOS LaunchAgent for claude, cursor-agent, codex, aider, and playwright.

Alternatives in Testing

Spec Kitty — Spec-Driven Development for serious software developers 1.6k ★
Spec Driven Develop — Spec-driven development workflow for AI coding agents: architecture-first planning, task decomposition, GitHub 975 ★
Spectra App — Spec-driven development for coding agents — a desktop app, a CLI, and skills for Codex, Claude Code, Cursor, C 735 ★

README

agent-reaper 🪦

Kill the zombie processes your AI coding agents leave behind.

[![License: MIT](https://img.shields.io/badge/License-MIT-0A4DFF.svg)](./LICENSE) [![Platform](https://img.shields.io/badge/platform-macOS-050606.svg)]() [![Homebrew](https://img.shields.io/badge/homebrew-tiagonrodrigues%2Ftap-0A4DFF.svg)](https://github.com/tiagonrodrigues/homebrew-tap) [![shellcheck](https://github.com/tiagonrodrigues/agent-reaper/actions/workflows/shellcheck.yml/badge.svg)](https://github.com/tiagonrodrigues/agent-reaper/actions/workflows/shellcheck.yml)

A tiny macOS tool that sweeps away abandoned Oh My Pi, `claude`, `cursor-agent`, `codex`, `aider`, Playwright, agent-browser, and MCP-server processes. Runs every 10 minutes in the background (configurable). A match is killable only after it has no live terminal owner and remains detached across repeated scans. Interactive browsers are hard-protected.

The repo is `agent-reaper`. The CLI you actually type is `reap`. Think of it like `homebrew` the project vs `brew` the command.

reap preview

The problem

If you live in AI-agent IDEs (T3 Code, Claude Code, Cursor Agent, Warp Agent Mode, Codex CLI, name your poison), you've probably noticed your Mac running hot for no obvious reason. One afternoon I actually checked:

30   claude CLI processes (only 2 of them actually in use)
80   orphaned opencode-ai servers (I don't even use opencode)
12   MCP servers from sessions that died hours ago
4    zombie Playwright Chromiums from a test run on Monday
load average: 4.90 · fan spinning · battery melting

Agent wrappers spawn child processes and don't always reap them when you close a session, switch projects, or the IDE crashes. They pile up silently for days.