claudekill
| Crates.io | claudekill |
| lib.rs | claudekill |
| version | 0.5.1 |
| created_at | 2026-01-04 19:26:51.83126+00 |
| updated_at | 2026-01-04 19:47:29.025234+00 |
| description | A high-velocity, terminal-native instrument designed to hunt down and neutralize .claude cache directories. |
| homepage | https://github.com/olbboy/claudekill |
| repository | https://github.com/olbboy/claudekill |
| max_upload_size | |
| id | 2022347 |
| size | 889,598 |
mds (olbboy)
documentation
https://github.com/olbboy/claudekill#readme
README
THE SURGICAL CACHE CLEANER
OBLITERATE NOISE. RECLAIM SPACE.
ClaudeKillis a high-velocity, terminal-native instrument designed to hunt down and neutralize.claudecache directories.
⚡️ SYSTEM CAPABILITIES
| 🚀 PARALLEL CORE | Multi-threaded filesystem traversal engine (jwalk). Scans sectors in milliseconds. |
| 🛡️ FAILSAFE | Safe Mode active. Targets are moved to Trash. Hard-delete is opt-in only. |
| 🕹️ TERMINAL UI | Keyboard-driven interface. VIM-style navigation. Pure retro feel. |
| 🔮 X-RAY | Real-time storage impact visualization. Know the cost before you purge. |
| 🔍 SEARCH & FILTER | Live search, sort by size/name/date, filter by project type. |
| ⏪ TIME REWIND | Undo deletions. View history. Restore from Trash. |
| 📊 INTEL REPORTS | Space analysis by project type, age breakdown. Export JSON/CSV. |
| ⚙️ CONFIGURABLE | TOML config file. Persistent preferences. Exclude patterns. |
📦 DEPLOYMENT
POSIX // MACOS
brew install olbboy/tap/claudekill
WINDOWS
cargo install claudekill
# OR via Binstall
cargo binstall claudekill
Manual: Download claudekill-x86_64-pc-windows-msvc.zip from Releases, extract, add to PATH.
LINUX // CARGO
cargo install claudekill
# OR via Binstall
cargo binstall claudekill
MANUAL // BINARY
- Access GITHUB RELEASES.
- Acquire target binary (
x86_64/aarch64/windows). - Execute.
🎮 COMMAND DECK
Run claudekill to initialize the visual interface.
$ claudekill
INTERFACE
┌────────────────────────────────────────────────────────────┐
│ SCANNING SECTOR: /Users/neo │
│ [24 TARGETS FOUND] │
│ │
│ [ ] ~/Projects/matrix-sim/.claude 1.2 GB │
│ [x] ~/Projects/legacy-zion/.claude 450 MB │
│ [ ] ~/Downloads/construct-v1/.claude 120 MB │
│ │
│ TOTAL SELECTED: 450 MB │
└────────────────────────────────────────────────────────────┘
↑/↓: NAVIGATE • SPACE: TOGGLE • d: EXECUTE TRASH
CLI ARGS
| PARAMETER | EFFECT |
|---|---|
--path <DIR> |
TARGET LOCK. Scan specific sector only. |
--dry-run |
RECON. List targets; no UI engagement. |
--include-global |
OVERRIDE. Scan ~/.claude global cache. |
--permanent |
INCINERATE. Bypass Recycle Bin/Trash. NO UNDO. |
--undo |
TIME REWIND. Restore last trash-based deletion. |
--history |
MISSION LOG. View deletion history. |
--report |
INTEL BRIEFING. Generate space analysis report. |
--export <FMT> |
DATA EXPORT. Output format: json or csv. |
--init-config |
INITIALIZE. Create default config file. |
--config-path |
LOCATE. Show config file path. |
KEYBINDINGS
| INPUT | ACTION |
|---|---|
k / ↑ |
UP |
j / ↓ |
DOWN |
PgUp / g |
PAGE UP / TOP |
PgDn / G |
PAGE DOWN / BOTTOM |
Home / End |
FIRST / LAST |
SPACE |
MARK TARGET |
a |
MARK ALL |
n |
UNMARK ALL |
d |
EXECUTE |
/ |
SEARCH MODE |
s |
CYCLE SORT (size/name/date) |
F |
TOGGLE FILTER BAR |
c |
CLEAR FILTERS |
? |
HELP |
q |
ABORT |
⚙️ CONFIGURATION
Initialize config: claudekill --init-config
Config location: ~/.config/claudekill/config.toml (macOS/Linux) or %APPDATA%\claudekill\config.toml (Windows)
[scan]
# default_paths = ["~/Projects", "~/Work"]
# exclude_patterns = ["node_modules", ".git"]
include_global = false
[display]
show_project_type = true
show_filter_bar = false
default_sort = "size_desc" # size_desc, size_asc, name_asc, name_desc, date_desc, date_asc
[behavior]
permanent_delete = false
confirm_delete = true
📚 INTELLIGENCE
- MISSION BRIEF // PROJECT GOALS
- SCHEMATICS // ARCHITECTURE
- PROTOCOLS // RELEASE GUIDE
MIT LICENSE // EST. 2024 // OPEN SOURCE