ArcadeAI Cleanup Zombies
Kill zombie processes (dev servers, Playwright browsers, test runners) for the current project only. Safe to use in multi-project environments.
Instructions
Run the cleanup script — it previews what would be killed (nothing dies without explicit consent; the preview-first ritual is script-enforced):
bun "${CODEX_HOME:-$HOME/.codex}/plugins/cache/safeword/safeword/1.0.0-rc.3/runtime/cli.js" project runtime cleanup-zombies --
If the preview looks correct, confirm the kill with --yes:
bun "${CODEX_HOME:-$HOME/.codex}/plugins/cache/safeword/safeword/1.0.0-rc.3/runtime/cli.js" project runtime cleanup-zombies -- --yes
What It Does
- Auto-detects framework - Finds port from vite.config.ts, next.config.js, etc. (checks root,
packages/*/,apps/*/for monorepos) - Checks project-owned port processes - Inspects the dev port and in-range test port (port + 1000), reporting owners it skips when project ownership cannot be verified
- Checks project-owned test processes - Inspects Playwright, Chromium, and Electron matches whose working directory is inside this project
- Revalidates before signaling - Only kills processes whose current working directory still belongs to this project
Manual Override
If auto-detection fails or you need a specific port:
# Explicit port (preview, then add --yes to kill)
bun "${CODEX_HOME:-$HOME/.codex}/plugins/cache/safeword/safeword/1.0.0-rc.3/runtime/cli.js" project runtime cleanup-zombies -- 5173
# Port + additional pattern
bun "${CODEX_HOME:-$HOME/.codex}/plugins/cache/safeword/safeword/1.0.0-rc.3/runtime/cli.js" project runtime cleanup-zombies -- --yes 5173 "electron"
When to Use
- Port already in use when starting dev server
- Tests hanging or failing due to zombie processes
- Switching between projects
- Before running E2E tests
- After interrupted test runs