dead-code

name	dead-code
description	Finds unused functions, variables, exports, and dependencies across the codebase
user-invocable	true
allowed-tools	Bash Grep Glob Read
effort	medium

Dead Code Analysis

1. Find unused exports (TypeScript/JS):

npx ts-prune 2>/dev/null || npx unimported 2>/dev/null || echo "Running manual search"

2. Manual search for likely dead code:

# Exported but never imported
grep -r "^export " src/ --include="*.ts" -l | head -20

# Functions defined but never called
grep -r "^function \|^const .* = (" src/ --include="*.ts" | head -30

3. For each candidate, verify by searching for all usages across the codebase.

4. Report categories:

   • Safe to delete: confirmed zero usages
   • Probably dead: only used in tests or commented-out code
   • Keep: used dynamically or via reflection

5. For safe-to-delete items: ask confirmation, then remove.

Never delete code you're not certain about - mark uncertain items with // TODO: verify unused.