---
description: Remove unused code, imports, and dead code
argument-hint: [path] - Optional path to cleanup (defaults to recent changes)
---

# Code Cleanup

## Pre-computed Context

**Recently Modified Files:**
!`git diff --name-only HEAD~5 2>/dev/null | grep -E '\.(ts|tsx|js|jsx|py)$' | head -15`

**TypeScript Config:**
!`cat tsconfig.json 2>/dev/null | grep -E '"(noUnused|strict)"' | head -5 || echo "No tsconfig.json"`

**ESLint Unused Rules:**
!`cat .eslintrc* eslint.config.* 2>/dev/null | grep -i unused | head -3 || echo "No ESLint config"`

---

## Instructions

You are cleaning up unused code from the codebase.

### What to Remove

#### 1. Unused Imports
```typescript
// Remove these
import { unusedFunction } from './utils';  // never used
import * as _ from 'lodash';  // never used
```

**Detection:**
```bash
# TypeScript/ESLint
npx eslint --rule 'no-unused-vars: error' --rule '@typescript-eslint/no-unused-vars: error' .

# Or use ts-prune for exports
npx ts-prune 2>/dev/null
```

#### 2. Unused Variables
```typescript
// Remove
const unusedConfig = { ... };  // declared but never read
function helper(used, unused) { return used; }  // unused parameter
```

#### 3. Dead Code
```typescript
// Remove unreachable code
function process() {
  return result;
  console.log('never runs');  // dead code
}

// Remove commented-out code
// function oldImplementation() { ... }  // delete, use git history
```

#### 4. Unused Exports
```typescript
// If not imported anywhere, consider removing
export function neverImported() { ... }
```

Use `ts-prune` to find unused exports:
```bash
npx ts-prune 2>/dev/null | head -20
```

### Automated Tools

#### ESLint Auto-fix
```bash
npx eslint --fix --rule 'no-unused-vars: error' .
```

#### TypeScript Strict Mode
Enable in tsconfig.json:
```json
{
  "compilerOptions": {
    "noUnusedLocals": true,
    "noUnusedParameters": true
  }
}
```

#### Python
```bash
# Find unused imports
autoflake --remove-all-unused-imports --in-place -r . 2>/dev/null

# Or with ruff
ruff check --select F401 --fix . 2>/dev/null
```

### Manual Review

For each file in the target path:

1. Read the file
2. Identify unused:
   - Imports at the top
   - Variables declared but not used
   - Functions defined but not called
   - Commented-out code blocks
3. Remove with Edit tool
4. Verify no errors introduced

### Safety Rules

1. **Don't remove exports** that might be used externally (public APIs)
2. **Check for side effects** - some imports run code on load
3. **Preserve intentional unused** - parameters with `_` prefix
4. **Run tests after cleanup** to verify nothing broke

### Report

```
## Cleanup Report

### Removed
- 15 unused imports
- 3 unused variables
- 2 dead code blocks
- 45 lines of commented code

### Files Cleaned
- src/utils.ts: -12 lines
- src/api/client.ts: -8 lines
```