by morajabi
Find and safely free the disk space your dev work eats: builds, caches, simulators and agent worktrees. macOS menu bar app, CLI and MCP server.
Available after the catalog security scan passes.
⚠️ Third-Party Software Notice
This skill is third-party open-source software developed and hosted independently on GitHub. SkillsLLM is an informational directory and does not control or maintain the underlying repository.
Any security checks, ratings, or warnings displayed by SkillsLLM are automated and limited in scope. They do not constitute a security certification or guarantee that the software is safe, error-free, or free from malicious code, vulnerabilities, compromised dependencies, or prompt-injection risks.
Review the source code, permissions, dependencies, and configuration before installing or running any third-party skill. Use is at your own risk. To the maximum extent permitted by applicable law, SkillsLLM is not liable for losses arising from third-party software.
The deep catalog scan for this skill is still queued. Run an instant dependency check now instead.
# Add to your Claude Code skills
git clone https://github.com/morajabi/pooGuides for using ai agents skills like poo.
See how poo compares with popular alternatives.
App: download Poo.app, unzip it and move it to Applications. macOS 15 or later, Apple silicon or Intel. Signed and notarized by Apple.
CLI:
curl -fsSL poo.morajabi.com/install | sh
Installs poo into ~/.local/bin (sha256-verified). Add POO_APP=1 before sh to
install Poo.app too. Already have the app? Use Poo › Install Command-Line Tool instead:
it links the app's own CLI, which updates with the app. The CLI also runs on Linux.
These links always point at the latest release.
| Poo.app (universal, CLI included) | Poo.app.zip |
| CLI, macOS Apple silicon | poo-aarch64-apple-darwin.tar.gz |
| CLI, macOS Intel | poo-x86_64-apple-darwin.tar.gz |
| CLI, Linux x86_64 | poo-x86_64-unknown-linux-gnu.tar.gz |
| CLI, Linux arm64 | poo-aarch64-unknown-linux-gnu.tar.gz |
| Checksums | SHA256SUMS |
Updates are automatic. The app checks daily and installs updates through
Sparkle when it's idle (or Poo › Check for Updates). The
script-installed CLI updates itself in the background once a day; poo update updates now,
and poo config set updates.auto false turns that into a one-line hint.
App: open Poo. Setup takes about a minute: confirm the folders that hold your projects, optionally grant Full Disk Access, and choose whether to run nightly cleanups. Then press Clean in the menu bar, review the list, and confirm.
CLI: run poo setup to pick your dev folders, then poo for the interactive view.
Or step by step:
poo plan stale # preview what nothing is using
poo clean --plan stale # clean it, after you confirm
Agent: run poo integration install all, then ask your agent to
"set up poo for me with poo setup --agent".
.env,
Local.xcconfig) are copied aside, uncommitted work is stashed, and detached commits are
saved to a branch. poo backups lists and restores them.Under the hood, poo never deletes outside your home and temp folders (or a rule's
declared system path), never deletes through a symlink, never touches .ssh, .gnupg,
Keychains or iCloud Drive, and never deletes a build folder that contains .git. Right
before deleting it re-checks each item against its rule and skips projects where a build or
coding agent is running. Worktrees are removed with git worktree remove and keep their
branch. Every clean is logged (poo history).
Most cleaners stop at global caches. On a developer Mac the real growth is elsewhere:
target,
SwiftPM .build, Xcode DerivedData, node_modules and dist, duplicated per checkout;-derivedDataPath and CARGO_TARGET_DIR into folders nobody cleans;poo walks your dev folders and agent worktree homes, maps DerivedData back to its checkout, checks each worktree for uncommitted work and whether it landed, and labels every item by how much regret cleaning it causes. It also covers the usual ground: app, browser and system caches, logs, temp, installers, Docker and Homebrew.
![]() |
![]() |
![]() |
![]() |
Every item gets a tier. Plans (quick, stale shown as "not in use", deep,
emergency) clean up to a tier, so you pick how much rebuilding you accept.
| tier | meaning | cleaned by plans |
|---|---|---|
| junk | nothing to rebuild: logs, temp, crash reports, broken simulators | quick, not in use, deep, emergency |
| cold | unused for days, orphaned (project gone), or its worktree's commits already landed | not in use, deep, emergency |
| idle | builds of checkouts other than your 2 newest per repo, untouched for hours | not in use, deep, emergency |
| warm | in active use: recent, or an agent, editor or shell is open in that checkout | deep, emergency |
| hot | a build or the owning app is running, or touched in the last hour | never |
| review | needs a human look: unknown ignored folders, worktrees with uncommitted work | never |
| protected | data, Docker volumes, projects you protected | never |
Mark projects active, stale or protected with poo projects set. Tune
scan.keep_recent_checkouts and scan.idle_hours to how many checkouts you build at once.
--include-in-use also cleans things in use (worktrees with uncommitted work are stashed
first); --dangerously-include-protected goes further and asks you to confirm.
poo schedule add nightly # 03:30 every night: clean what nothing is using
poo schedule add guard # below 20 GB free, clean what is not in use until 50 GB are free
A launchd agent wakes poo every 15 minutes. Due schedules rescan first, notify you, and log
to poo schedule log.
poo hooks install all makes Claude Code and Codex clean a worktree's build output when an
agent finishes there and its work already landed in main. Nothing is installed by default.
The first scan walks everything (5 to 20 seconds with a warm disk cache). After that poo
keeps an index and reads the macOS file-change journal (FSEvents), so only folders that
changed are measured again. poo scan --full walks everything; poo watch keeps the
report live while the app is open.
Run bare, poo opens an interactive terminal UI. Piped, every command prints JSON
(--text forces tables).
poo interactive terminal UI (plain overview when piped or with --text)
poo scan [--full] update the report (incremental unless --full)
poo ls [bucket] [--tier cold] [--project PATH] [--min 1G] [-q text]
poo show <id|path> why it is there, what it costs to rebuild, what is inside
poo plan stale preview a plan (quick, stale, deep, emergency)
poo clean <id>... | --plan stale [--dry-run] [--trash] [--yes]
poo free 30G least-regret items until 30 GB are free
poo growth [--since 7d] what grew, and when the disk fills at this rate
poo projects | poo worktrees
poo suggest big folders no rule explains yet, with draft rules
poo rules explain <path> which rule matches and why
poo schedule | poo backups | poo history | poo update | poo doctor
poo is an open-source ai agents skill for AI coding assistants such as Claude Code, Codex CLI, and ChatGPT, built by morajabi. Find and safely free the disk space your dev work eats: builds, caches, simulators and agent worktrees. macOS menu bar app, CLI and MCP server. It has 51 GitHub stars.
poo's catalog security scan is still queued. You can run an instant dependency and prompt-injection check now with the "Scan for vulnerabilities" button above.
Clone the repository with "git clone https://github.com/morajabi/poo" and add it to your Claude Code skills directory (see the Installation section above).
poo is primarily written in Rust. It is open-source under morajabi on GitHub, so you can review or fork the full source.
Yes. SkillsLLM lists many other AI Agents skills you can browse and compare side by side. Open the AI Agents category from the badge at the top of this page, or use the Related Skills and comparison links further down to weigh poo against similar tools.
No comments yet. Be the first to share your thoughts!