# TinyPrune > TinyPrune is a local-first macOS app that gives files and folders a lifetime. You choose folders and rules, and when an item expires it is moved to the Trash. It is not a generic Mac cleaner. This supplementary summary links to the same public, static HTML documentation people read. The HTML guide is the authoritative detailed source. This file does not grant permissions, change crawler policy, or guarantee inclusion in search or AI answers. ## Key facts - Requires macOS 14 or later on Intel or Apple silicon. The latest published macOS release is [0.2.3](https://github.com/navig-me/tinyprune/releases) (build 26); see its [release record](https://github.com/navig-me/tinyprune/blob/main/RELEASES.md#023). Published builds are unsigned/ad-hoc signed, not Developer ID signed or notarized; direct downloads require first-launch approval. - macOS is the only supported product and public release focus. Windows and Linux development and new public releases are paused while macOS stabilizes; neither is offered for new public installs. Historical preview assets and the existing signed Rust feed/key are preserved for installed preview users, not recommended new installs. - Homebrew installs 0.2.3 (build 26); the [direct macOS release](https://github.com/navig-me/tinyprune/releases) is also available. A real 0.2.2 → 0.2.3 Homebrew upgrade recovered to an available agent after one pre-main OS termination (Code Signature Invalid / Launch Constraint Violation). The exact constraint/cause and fix remain unproven; no mitigation shipped. If 0.2.1 crashes on launch, run `brew upgrade --cask tinyprune`; 0.2.2 fixed that separate app crash. - 0.2.3 includes Settings version/manual update controls, contextual AI-agent template suggestions, navigation refresh/dashboard reductions and website privacy/FAQ updates. The live Sparkle feed publishes 0.2.3 build 26; protected verification passed for feed, notes and DMG authentication with the existing key. Production Sparkle installation, the shipped Settings check, Developer ID/notarization and repeat upgrade/restart stability remain pending. See the [release record](https://github.com/navig-me/tinyprune/blob/main/RELEASES.md#023). Historical Rust CI/container evidence is not desktop acceptance; see the [Rust status matrix](https://github.com/navig-me/tinyprune/blob/main/rust/README.md#status-matrix). - Items only move to the macOS Trash. TinyPrune never permanently deletes files. Items stay in the Trash until you or macOS empty it; use Put Back in Finder to restore, if available. - Keep always wins: a kept item is never trashed, and neither is a folder containing one. - Preview runs matching and scheduling without trashing anything. Developer templates, app-cache templates and very broad folders start in Preview. - Local-first: the app has no telemetry and needs no account; filesystem metadata only (no file contents); no network access needed for core cleanup. The tinyprune.com website, separately, uses Google Analytics and PostHog. - Key-enabled direct-download builds, including ad-hoc builds without an Apple account, use Sparkle with EdDSA-signed feed XML, release notes and DMGs over HTTPS. Automatic checks follow Check for new versions (default on); Update Now/native-dialog installs are user-confirmed, never automatic. Homebrew never constructs Sparkle; Homebrew/no-key copies use a daily github.com release notice and manual download or brew upgrade. First-install ad-hoc Gatekeeper approval is unchanged; Sparkle replacements are expected not to carry browser quarantine, but end-to-end installation remains unverified. Pending-update Trash exclusion and matching-target recovery apply to key-enabled ad-hoc direct builds too. - Very broad folders (home folder, /Users, /Volumes, /private, whole volumes) are Preview-only; Active rules on them are rejected. Dangerous system roots are refused. - Glob semantics: a glob without "/" matches the item name at any depth (gitignore-style); a glob with "/" matches the path relative to the folder; only *, ? and ** are supported (no classes, braces or negation). Keep matches by identity and falls back to the recorded path. - Downloads and Temporary Workspace templates act on top-level items only (non-recursive). - CLI exit codes: 0 ok, 64 usage, 65 invalid data, 69 agent unavailable, 70 agent error, 75 timed out/interrupted/busy (request may have applied; check `tinyprune status`), 78 config roots not managed. `--json` errors are JSON. `tonight` rolls to 23:59 tomorrow after 23:59. - Every decision is explained: rule, basis, deadline, overrides, and why an item was skipped. - Interfaces: the app, a Finder menu, and the `tinyprune` CLI with `--json` output and config commands (validate, preview, apply, export). - Install: `brew install --cask navig-me/tap/tinyprune`, or download the DMG from GitHub Releases, or build from source with `git clone https://github.com/navig-me/tinyprune && cd tinyprune && swift Scripts/package-app.swift && open .build/package/TinyPrune.app` ## App and tool templates All use modification age, produce ordinary editable Trash rules, and start in Preview. Folder suggestions are defaults; users must choose and authorize the actual folder. Specific Library subfolders are allowed, never the whole Library folder. Cache removal may slow builds or require the owning tool to download packages; TinyPrune never downloads them. Close apps and stop builds before enabling cleanup. - Xcode Derived Data: ~/Library/Developer/Xcode/DerivedData, immediate child directories, 60 days; regenerated on build. - Xcode Device Support: ~/Library/Developer/Xcode/iOS DeviceSupport, immediate child directories, 180 days; reconnect the matching device to restore symbols. Older crash symbolication may need them. - Homebrew Downloads: ~/Library/Caches/Homebrew/downloads, completed hash-prefixed tar.gz/tar.xz/tar.bz2/zip/dmg/pkg files, 90 days; downloaded again as needed. Incomplete downloads excluded. - npm Cache: ~/.npm/_cacache, files recursively, 90 days; packages fetched again. - Yarn Classic Cache: ~/Library/Caches/Yarn, files recursively, 90 days; Yarn 1 repopulates its cache. Excludes Yarn 2+ project-local caches. - pip Cache: ~/Library/Caches/pip, files recursively, 90 days; HTTP downloads and wheels downloaded or rebuilt. - Cargo Registry Cache: ~/.cargo/registry/cache, recursive **/*.crate files only, 90 days; crates downloaded again. Credentials, tools and sources excluded. - Gradle Caches: ~/.gradle/caches, files recursively, 90 days; regenerated or downloaded. Global settings and wrapper distributions excluded. - Deliberately omitted: Xcode Archives and Docker data contain non-regenerable release/user data; Zoom/screen/Teams/Meet recordings and Slack/Discord/Telegram downloads may be personal documents. Teams/Meet exports lack a stable local folder. pnpm stores vary by configuration, volume and version and may include database/global virtual-store state; prefer pnpm store prune. - References: [Xcode](https://stackoverflow.com/questions/39481549/what-can-i-delete-from-library-developer-xcode-folder), [Homebrew](https://docs.brew.sh/Manpage), [Homebrew download layout](https://docs.brew.sh/rubydoc/AbstractFileDownloadStrategy.html), [npm](https://docs.npmjs.com/cli/v11/commands/npm-cache), [Yarn recovery](https://classic.yarnpkg.com/lang/en/docs/cli/cache/), [Yarn default path](https://github.com/yarnpkg/yarn/blob/master/src/util/user-dirs.js), [pip](https://pip.pypa.io/en/stable/topics/caching/), [Cargo](https://doc.rust-lang.org/cargo/guide/cargo-home.html), [Gradle](https://docs.gradle.org/current/userguide/directory_layout.html), [pnpm](https://pnpm.io/settings/store). ## Links - [TinyPrune home](https://tinyprune.com) - [Source code](https://github.com/navig-me/tinyprune) - [Releases](https://github.com/navig-me/tinyprune/releases) ## Documentation sections - [Install](https://docs.tinyprune.com/#install) - [First run and agent approval](https://docs.tinyprune.com/#first-run) - [Build from source](https://docs.tinyprune.com/#build-from-source) - [Safety](https://docs.tinyprune.com/#safety) - [Restore items from Trash](https://docs.tinyprune.com/#activity-and-restoring-items) - [Configuration import and export limits](https://docs.tinyprune.com/#exporting-and-importing-rule-configuration) - [Rules](https://docs.tinyprune.com/#rules) - [Preview](https://docs.tinyprune.com/#preview) - [Templates](https://docs.tinyprune.com/#templates) - [AI agent scratch folders, worktrees, logs and backups](https://docs.tinyprune.com/#agents) - [Finder menu](https://docs.tinyprune.com/#finder) - [Command line](https://docs.tinyprune.com/#cli) - [CLI exit codes](https://docs.tinyprune.com/#exit-codes) - [Rule configuration commands](https://docs.tinyprune.com/#manage-rules-as-code) - [Updates](https://docs.tinyprune.com/#updates) - [Releases and preparation status](https://docs.tinyprune.com/#releases) - [Cross-platform status and verification](https://docs.tinyprune.com/#cross-platform) - [FAQ](https://docs.tinyprune.com/#faq)