Skip to content
Back to search

poo

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 17 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/morajabi/poo with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/morajabi/poo'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/morajabi--poo/badge.svg)](/listings/morajabi--poo)

HTML

<a href="/listings/morajabi--poo"><img src="/api/listings/morajabi--poo/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

These steps run a script from the network that findsafeskills does not scan.

**App:** [download Poo.app](https://github.com/morajabi/poo/releases/latest/download/Poo.app.zip), 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.

<details> <summary>Direct downloads</summary>

These links always point at the [latest release](https://github.com/morajabi/poo/releases/latest).

| | | |---|---| | Poo.app (universal, CLI included) | [Poo.app.zip](https://github.com/morajabi/poo/releases/latest/download/Poo.app.zip) | | CLI, macOS Apple silicon | [poo-aarch64-apple-darwin.tar.gz](https://github.com/morajabi/poo/releases/latest/download/poo-aarch64-apple-darwin.tar.gz) | | CLI, macOS Intel | [poo-x86_64-apple-darwin.tar.gz](https://github.com/morajabi/poo/releases/latest/download/poo-x86_64-apple-darwin.tar.gz) | | CLI, Linux x86_64 | [poo-x86_64-unknown-linux-gnu.tar.gz](https://github.com/morajabi/poo/releases/latest/download/poo-x86_64-unknown-linux-gnu.tar.gz) | | CLI, Linux arm64 | [poo-aarch64-unknown-linux-gnu.tar.gz](https://github.com/morajabi/poo/releases/latest/download/poo-aarch64-unknown-linux-gnu.tar.gz) | | Checksums | [SHA256SUMS](https://github.com/morajabi/poo/releases/latest/download/SHA256SUMS) |

</details>

**Updates are automatic.** The app checks daily and installs updates through [Sparkle](https://sparkle-project.org) 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.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 271 lines · 1 finding marked
  1. <p align="center">
  2. <img src="docs/images/icon.png" alt="Poo" width="128">
  3. </p>
  4. <h1 align="center">Poo</h1>
  5. <p align="center">
  6. Find and safely free the disk space your dev work eats.
  7. <br>
  8. A menu bar app and CLI for macOS, with an MCP server and skill for your coding agent.
  9. </p>
  10. <p align="center">
  11. <a href="https://poo.morajabi.com">Website</a>
  12. ·
  13. <a href="https://github.com/morajabi/poo/releases/latest/download/Poo.app.zip">Download</a>
  14. ·
  15. <a href="#install">Install</a>
  16. ·
  17. <a href="docs/mods.md">Rules and mods</a>
  18. ·
  19. <a href="CONTRIBUTING.md">Contributing</a>
  20. </p>
  21. <p align="center">
  22. <a href="https://github.com/morajabi/poo/releases/latest"><img src="https://img.shields.io/github/v/release/morajabi/poo?sort=semver&label=release" alt="Latest release"></a>
  23. <a href="https://github.com/morajabi/poo/actions/workflows/ci.yml"><img src="https://github.com/morajabi/poo/actions/workflows/ci.yml/badge.svg?branch=main" alt="CI"></a>
  24. <a href="#install"><img src="https://img.shields.io/badge/macOS-15%2B-black?logo=apple" alt="macOS 15+"></a>
  25. <a href="LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT license"></a>
  26. </p>
  27. <p align="center">
  28. <img src="docs/images/overview.png" alt="The Poo window: free space, and what is not in use grouped by what a clean costs you" width="100%">
  29. </p>
  30. <p align="center">
  31. <img src="docs/images/menubar-expanded.png" alt="The menu bar panel: free space, one Clean button, the areas behind it" width="49%">
  32. <img src="docs/images/cli-overview.png" alt="The poo terminal UI overview" width="49%">
  33. </p>
  34. ## Install
  35. **App:** [download Poo.app](https://github.com/morajabi/poo/releases/latest/download/Poo.app.zip),
  36. unzip it and move it to Applications. macOS 15 or later, Apple silicon or Intel. Signed
  37. and notarized by Apple.
  38. **CLI:**
  39. ```sh
  40. curl -fsSL poo.morajabi.com/install | sh
    • Note: Pipes a downloaded script directly into a shell (curl | sh / wget | bash)
    • Line 49 on GitHub
  41. ```
  42. Installs `poo` into `~/.local/bin` (sha256-verified). Add `POO_APP=1` before `sh` to
  43. install Poo.app too. Already have the app? Use **Poo › Install Command-Line Tool** instead:
  44. it links the app's own CLI, which updates with the app. The CLI also runs on Linux.
  45. <details>
  46. <summary>Direct downloads</summary>
  47. These links always point at the [latest release](https://github.com/morajabi/poo/releases/latest).
  48. | | |
  49. |---|---|
  50. | Poo.app (universal, CLI included) | [Poo.app.zip](https://github.com/morajabi/poo/releases/latest/download/Poo.app.zip) |
  51. | CLI, macOS Apple silicon | [poo-aarch64-apple-darwin.tar.gz](https://github.com/morajabi/poo/releases/latest/download/poo-aarch64-apple-darwin.tar.gz) |
  52. | CLI, macOS Intel | [poo-x86_64-apple-darwin.tar.gz](https://github.com/morajabi/poo/releases/latest/download/poo-x86_64-apple-darwin.tar.gz) |
  53. | CLI, Linux x86_64 | [poo-x86_64-unknown-linux-gnu.tar.gz](https://github.com/morajabi/poo/releases/latest/download/poo-x86_64-unknown-linux-gnu.tar.gz) |
  54. | CLI, Linux arm64 | [poo-aarch64-unknown-linux-gnu.tar.gz](https://github.com/morajabi/poo/releases/latest/download/poo-aarch64-unknown-linux-gnu.tar.gz) |
  55. | Checksums | [SHA256SUMS](https://github.com/morajabi/poo/releases/latest/download/SHA256SUMS) |
  56. </details>
  57. **Updates are automatic.** The app checks daily and installs updates through
  58. [Sparkle](https://sparkle-project.org) when it's idle (or Poo › Check for Updates). The
  59. script-installed CLI updates itself in the background once a day; `poo update` updates now,
  60. and `poo config set updates.auto false` turns that into a one-line hint.
  61. ## Quick start
  62. - **App:** open Poo. Setup takes about a minute: confirm the folders that hold your
  63. projects, optionally grant Full Disk Access, and choose whether to run nightly cleanups.
  64. Then press **Clean** in the menu bar, review the list, and confirm.
  65. - **CLI:** run `poo setup` to pick your dev folders, then `poo` for the interactive view.
  66. Or step by step:
  67. ```sh
  68. poo plan stale # preview what nothing is using
  69. poo clean --plan stale # clean it, after you confirm
  70. ```
  71. - **Agent:** run `poo integration install all`, then ask your agent to
  72. *"set up poo for me with `poo setup --agent`"*.
  73. ## Safety and privacy
  74. - **Nothing is deleted until you review and confirm it**, or turn on a schedule or hook
  75. yourself. Plans never include anything running, anything that needs a look, or
  76. anything protected.
  77. - **Worktrees are backed up before removal:** small ignored files (`.env`,
  78. `Local.xcconfig`) are copied aside, uncommitted work is stashed, and detached commits are
  79. saved to a branch. `poo backups` lists and restores them.
  80. - **Full Disk Access is optional.** It is one switch in System Settings. Without it, poo
  81. skips the folders macOS guards and says so once, instead of prompting folder by folder.
  82. - **No account, no telemetry.** The only network calls are update checks to GitHub, and
  83. [sharing a rule](#share-a-rule) when you ask for it.
  84. Under the hood, poo never deletes outside your home and temp folders (or a rule's
  85. declared system path), never deletes through a symlink, never touches `.ssh`, `.gnupg`,
  86. Keychains or iCloud Drive, and never deletes a build folder that contains `.git`. Right
  87. before deleting it re-checks each item against its rule and skips projects where a build or
  88. coding agent is running. Worktrees are removed with `git worktree remove` and keep their
  89. branch. Every clean is logged (`poo history`).
  90. ## What it finds
  91. Most cleaners stop at global caches. On a developer Mac the real growth is elsewhere:
  92. - every worktree (yours, Claude Code's, Codex's, Conductor's) gets its own Rust `target`,
  93. SwiftPM `.build`, Xcode DerivedData, `node_modules` and `dist`, duplicated per checkout;
  94. - agents pass `-derivedDataPath` and `CARGO_TARGET_DIR` into folders nobody cleans;
  95. - merged worktrees, old simulators and runtimes, superseded toolchains and agent CLI
  96. versions pile up.
  97. poo walks your dev folders and agent worktree homes, maps DerivedData back to its checkout,
  98. checks each worktree for uncommitted work and whether it landed, and labels every item by
  99. how much regret cleaning it causes. It also covers the usual ground: app, browser and
  100. system caches, logs, temp, installers, Docker and Homebrew.
  101. | | |
  102. |---|---|
  103. | ![Browse every item, with why it is there and what cleaning it costs](docs/images/browse.png) | ![Elsewhere on This Mac: snapshots, purgeable space and device backups Poo explains but leaves alone](docs/images/elsewhere.png) |
  104. | ![Cleaning progress with a running total and Stop](docs/images/cleaning.png) | ![After a clean: freed space and what was backed up](docs/images/freed.png) |
  105. ## Features
  106. ### Tiers and plans
  107. Every item gets a tier. Plans (`quick`, `stale` shown as "not in use", `deep`,
  108. `emergency`) clean up to a tier, so you pick how much rebuilding you accept.
  109. | tier | meaning | cleaned by plans |
  110. |---|---|---|
  111. | junk | nothing to rebuild: logs, temp, crash reports, broken simulators | quick, not in use, deep, emergency |
  112. | cold | unused for days, orphaned (project gone), or its worktree's commits already landed | not in use, deep, emergency |
  113. | idle | builds of checkouts other than your 2 newest per repo, untouched for hours | not in use, deep, emergency |
  114. | warm | in active use: recent, or an agent, editor or shell is open in that checkout | deep, emergency |
  115. | hot | a build or the owning app is running, or touched in the last hour | never |
  116. | review | needs a human look: unknown ignored folders, worktrees with uncommitted work | never |
  117. | protected | data, Docker volumes, projects you protected | never |
  118. Mark projects `active`, `stale` or `protected` with `poo projects set`. Tune
  119. `scan.keep_recent_checkouts` and `scan.idle_hours` to how many checkouts you build at once.
  120. `--include-in-use` also cleans things in use (worktrees with uncommitted work are stashed
  121. first); `--dangerously-include-protected` goes further and asks you to confirm.
  122. ### Routine cleanups
  123. ```sh
  124. poo schedule add nightly # 03:30 every night: clean what nothing is using
  125. poo schedule add guard # below 20 GB free, clean what is not in use until 50 GB are free
  126. ```
  127. A launchd agent wakes poo every 15 minutes. Due schedules rescan first, notify you, and log
  128. to `poo schedule log`.
  129. ### Agent hooks (opt-in)
  130. `poo hooks install all` makes Claude Code and Codex clean a worktree's build output when an
  131. agent finishes there and its work already landed in main. Nothing is installed by default.
  132. ### Fast, current numbers
  133. The first scan walks everything (5 to 20 seconds with a warm disk cache). After that poo
  134. keeps an index and reads the macOS file-change journal (FSEvents), so only folders that
  135. changed are measured again. `poo scan --full` walks everything; `poo watch` keeps the
  136. report live while the app is open.
  137. ## CLI
  138. Run bare, `poo` opens an interactive terminal UI. Piped, every command prints JSON
  139. (`--text` forces tables).
  140. <p align="center">
  141. <img src="docs/images/cli-browse.png" alt="poo terminal UI browse view" width="49%">
  142. <img src="docs/images/cli-clean.png" alt="poo cleaning in the terminal" width="49%">
  143. </p>
  144. ```
  145. poo interactive terminal UI (plain overview when piped or with --text)
  146. poo scan [--full] update the report (incremental unless --full)
  147. poo ls [bucket] [--tier cold] [--project PATH] [--min 1G] [-q text]
  148. poo show <id|path> why it is there, what it costs to rebuild, what is inside
  149. poo plan stale preview a plan (quick, stale, deep, emergency)
  150. poo clean <id>... | --plan stale [--dry-run] [--trash] [--yes]
  151. poo free 30G least-regret items until 30 GB are free
  152. poo growth [--since 7d] what grew, and when the disk fills at this rate
  153. poo projects | poo worktrees
  154. poo suggest big folders no rule explains yet, with draft rules
  155. poo rules explain <path> which rule matches and why
  156. poo schedule | poo backups | poo history | poo update | poo doctor
  157. ```
  158. <p align="center">
  159. <img src="docs/images/cli-plan.png" alt="poo plan stale: what nothing is using, with size, status and last use" width="100%">
  160. </p>
  161. `poo --help` lists everything. Errors are `{"error":{"kind","message","hint"}}` with
  162. stable exit codes: 2 usage, 3 not found, 5 needs approval, 6 partial failure, 7 update
  163. failed, 8 invalid config or mods, 9 busy.
  164. ## For coding agents
  165. ```sh
  166. poo integration install all # skill + MCP for Claude Code, Codex, Cursor, OpenCode, Gemini CLI, Windsurf, Claude desktop
  167. npx skills add morajabi/poo --skill poo -g # skill only, via the open skills CLI
  168. ```
  169. The MCP server (`poo mcp`) gives agents tools to see the overview, list and inspect items,
  170. preview plans, clean (dry run by default), explain paths and configure poo. Agents may
  171. clean up to the tier you allow (`poo config set agents.auto_clean_max_tier cold`, the
  172. default); anything above needs your approval.
  173. `poo setup --agent` prints a brief with your disk, projects, duplication across worktrees
  174. and the questions worth asking you, so an agent can tailor poo to your workflow.
  175. ## Configuration and mods
  176. Settings live in `~/.config/poo/config.toml` (`poo config keys` lists them). Everything poo
  177. knows is a built-in mod in the same TOML format you can write: about 650 rules and 96
  178. project stacks, covering
  179. - **Apple:** DerivedData (including custom `-derivedDataPath` folders), simulators and
  180. runtimes, device support, previews, SwiftPM, CocoaPods, Carthage, Tuist.
  181. - **JS and Python:** npm, pnpm, Yarn, Bun, Deno, Next, Vite, Turbo, Nx, Expo, Playwright;
  182. pip, uv, Poetry, conda, pyenv, Jupyter, Hugging Face and torch models.
  183. - **Systems and JVM:** Rust, Go, Zig, C/C++, Bazel, Nix, Gradle, Maven, Android SDK and
  184. emulators.
  185. - **More:** Ruby, PHP, Elixir, Haskell, .NET, Flutter, embedded toolchains and more.
  186. - **Infra:** Docker, OrbStack, Colima, Podman, Lima, UTM, Terraform and cloud CLIs.
  187. - **AI:** worktrees and caches of Claude Code, Codex, Cursor, Conductor and other agent
  188. tools, plus Ollama, LM Studio and other local model stores.
  189. - **macOS:** app, browser and Electron caches, logs, crash reports, installers, app
  190. leftovers and the Trash.
  191. Generic folder names (`dist`, `build`, `out`, `vendor`) need proof they are build output,
  192. so a committed folder never matches.
  193. Add rules, override any field, disable rules, add buckets, or write providers and guards in
  194. any language: see [docs/mods.md](docs/mods.md) or `poo mods docs`.
  195. ### Share a rule
  196. Your Mac has folders ours never sees. `poo suggest` drafts a rule for each big folder no
  197. rule explains; `poo mods submit <mod>` lints it, strips your paths and names, shows you
  198. exactly what would be sent, and only then opens a pull request. See
  199. [CONTRIBUTING.md](CONTRIBUTING.md).
  200. ## Development
  201. ```sh
  202. cargo build --release # CLI
  203. ./scripts/build-app.sh # dist/Poo.app with the CLI bundled
  204. ```
  205. - [CONTRIBUTING.md](CONTRIBUTING.md): rules, fixtures, checks and code layout.
  206. - [docs/mods.md](docs/mods.md): the mod and rule format.
  207. - [docs/releasing.md](docs/releasing.md): the release pipeline, signing and Sparkle keys.
  208. Homebrew formula and cask are in progress (`packaging/homebrew`).
  209. ## License
  210. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.