Find unused functions and dead code in the codebase
Find unused functions and dead code using TLDR static analysis.
# Scan entire project
tldr dead .
# Scan specific directory
tldr dead src/
# Specify entry points (functions to exclude from analysis)
tldr dead . --entry main cli test_
# Specify language
tldr dead . --lang python
tldr dead . --lang typescript
Dead code analysis:
Total functions: 150
Dead functions: 12
Unused functions:
- old_helper (src/utils.py:42)
- deprecated_func (src/legacy.py:15)
- _unused_method (src/api.py:230)
Works on Windows, Mac, and Linux (including WSL).
# Windows (PowerShell)
tldr dead .
# Mac/Linux
tldr dead .
Functions matching entry patterns are excluded from dead code analysis:
main, cli - Application entry pointstest_*, *_test - Test functionssetup, teardown - Fixtures@app.route, @api.endpoint - Framework handlers# Custom entry points
tldr dead src/ --entry main api_handler background_job
This skill replaces the session-start-dead-code hook with on-demand analysis.
| Approach | Pros | Cons | |----------|------|------| | Hook (removed) | Automatic | Slowed startup by 3s | | Skill (this) | On-demand, fast | Manual invocation |
# Impact analysis (who calls this?)
tldr impact func_name .
# Architecture layers
tldr arch src/
# Full codebase structure
tldr structure . --lang python
BluOS CLI (blu) for discovery, playback, grouping, and volume.
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
Query Google Places API (New) via the goplaces CLI for text search, place details, resolve, and reviews. Use for human-friendly place lookup or JSON output for scripts.
Control Philips Hue lights and scenes via the OpenHue CLI.
Create or update AgentSkills. Use when designing, structuring, or packaging skills with scripts, references, and assets.
Delegate coding tasks to Codex, Claude Code, or Pi agents via background process. Use when: (1) building/creating new features or apps, (2) reviewing PRs (spawn in temp dir), (3) refactoring large codebases, (4) iterative coding that needs file exploration. NOT for: simple one-liner fixes (just edit), reading code (use read tool), thread-bound ACP harness requests in chat (for example spawn/run Codex or Claude Code in a Discord thread; use sessions_spawn with runtime:"acp"), or any work in ~/clawd workspace (never spawn agents here). Claude Code: use --print --permission-mode bypassPermissions (no PTY). Codex/Pi/OpenCode: pty:true required.
Category:developer