Plugin name
mac-storage-cleaner
Short description
A macOS disk cleaner that previews before it deletes: automatic removal is limited to a vetted allowlist of regenerable caches, anything riskier is moved to the Trash instead of removed, and a path validator refuses Photos libraries, iOS backups, keychains and SSH key directories in code. Every action is written to an audit log, and the scripts refuse to run when that log is unwritable.
GitHub repository
JubaKitiashvili/mac-storage-cleaner
Plugin path inside the repository
Ref to review
v3.0.0
Commit SHA to review
9b122135a30df7779b7ca812792e678a2cf20b5b
Version
3.0.0
License identifier
MIT
Author name
Juba Kitiashvili
Author URL
https://github.com/JubaKitiashvili
Homepage URL
Keywords
macos, disk-space, cache, cleanup, storage, developer-tools
Additional notes for reviewers
Platform scope: macOS only, and it requires an agent with real local shell access — it runs five bash scripts against the host filesystem (~/Library/Caches, ~/Library/Developer, the user's Trash). It is a good fit for Copilot CLI; it cannot function in a sandboxed or containerised review environment, where it will correctly find nothing to clean.
Safety design, since the plugin can delete files: preview is the default and clean-safe.sh deletes only when passed --apply; trash-items.sh refuses batches over 100 items or 5 GB without --force and rejects unrecognised flags rather than treating them as paths; the deny list is enforced by a path validator with a 47-entry corpus test asserting every dangerous path is refused. No sudo, and the scripts make no network requests. 131 tests run in CI on macos-latest (bats + shellcheck).
SKILL.md contains a mechanism-level "declared behavior" section enumerating every destructive operation, intended for automated review.
Submission checklist
Plugin name
mac-storage-cleaner
Short description
A macOS disk cleaner that previews before it deletes: automatic removal is limited to a vetted allowlist of regenerable caches, anything riskier is moved to the Trash instead of removed, and a path validator refuses Photos libraries, iOS backups, keychains and SSH key directories in code. Every action is written to an audit log, and the scripts refuse to run when that log is unwritable.
GitHub repository
JubaKitiashvili/mac-storage-cleaner
Plugin path inside the repository
Ref to review
v3.0.0
Commit SHA to review
9b122135a30df7779b7ca812792e678a2cf20b5b
Version
3.0.0
License identifier
MIT
Author name
Juba Kitiashvili
Author URL
https://github.com/JubaKitiashvili
Homepage URL
Keywords
macos, disk-space, cache, cleanup, storage, developer-tools
Additional notes for reviewers
Platform scope: macOS only, and it requires an agent with real local shell access — it runs five bash scripts against the host filesystem (
~/Library/Caches,~/Library/Developer, the user's Trash). It is a good fit for Copilot CLI; it cannot function in a sandboxed or containerised review environment, where it will correctly find nothing to clean.Safety design, since the plugin can delete files: preview is the default and
clean-safe.shdeletes only when passed--apply;trash-items.shrefuses batches over 100 items or 5 GB without--forceand rejects unrecognised flags rather than treating them as paths; the deny list is enforced by a path validator with a 47-entry corpus test asserting every dangerous path is refused. Nosudo, and the scripts make no network requests. 131 tests run in CI on macos-latest (bats + shellcheck).SKILL.md contains a mechanism-level "declared behavior" section enumerating every destructive operation, intended for automated review.
Submission checklist