Skip to content

Latest commit

 

History

2 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

entropy

Reclaim the machine.

entropy scanning a Mac

Coding agents start things and walk away. Headless browsers that outlive their session, dev servers from last week, a review broker for every repo you've touched, worktrees nobody remembers, and caches that only ever grow. I had to kill about 200 stray Chrome processes by hand before I went looking.

Entropy is a skill for Claude Code and Codex. It scans a Mac in under 20 seconds, ranks what it finds by what it's costing you, and clears only the rows you pick.

Install

git clone https://github.com/noeltock/entropy.git ~/.claude/skills/entropy
ln -s ~/.claude/skills/entropy ~/.codex/skills/entropy   # Codex, optional

Use

/entropy                  scan, then reply with IDs (E1 E4) or "safe"
/entropy --all            include the small stuff
/entropy --held           show everything it won't touch, and why
/entropy --deep           the slow scans, when you actually want them
/entropy --host <ssh>     same scan on another Mac

What it won't do

Touch a worktree with uncommitted or unpushed work, prune Docker volumes, delete a Docker Desktop disk before checking what's inside, kill a browser another session is still using, or act on anything you didn't pick. Caches go through each tool's own clean command, so nothing sits in the Trash pretending to be free space.

Tuning

Paths and time budgets live at the top of scripts/entropy.sh (override any of them with ENTROPY_* env vars). A new culprit is one line in references/culprits.tsv.

Evals

bash evals/run.sh --no-agent runs the deterministic tests in about 15 seconds, no model needed. Drop --no-agent to also run the agent scenarios through claude -p against a fake home folder, with every delete swapped for a logger. That part costs tokens. More in evals/README.md.

macOS only. It won't beat the second law, but it slows it down.

About

Reclaim the machine.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages