# Binky

> Native macOS organizer: **Quick Sort** for one-shot clears, **Routines** for always-on watches. No cloud, no guessing — your rules, stable-file patience, sorted destinations, Review for unknowns. Runs locally. The pacifier for a fussy folder.

## What it does

- **Quick Sort** — pick a folder, **Sort Now**; stable-file gate and collision-safe moves; **⌘1** in the app
- **Routines** — multiple named watchers (each with its own source and rules) plus global fallback when needed; **⌘2** in the app (same routing as Quick Sort)
- **Destinations** — Images, PDFs, Media, Documents, Archives, Apps, Screenshots, Misc
- **Source-aware routing** — rules can use where a file came from (browser metadata) and content matches
- **Describe a rule** — plain-English rule building where the OS supports it; manual editor always available
- **Receipt & invoice detection** — PDF and image cues for financial documents
- **Duplicate guard** — hashes files to catch duplicates before routing
- **Smart screenshot names** — Vision reads screens; filenames follow the content
- **Stale-file aging** — optional archive for untouched files (housekeeping)
- **Daily digest** — one notification summarizing moves, renames, and archives
- **Weekly digest reminder** — optional scheduled nudge; shareable digest card (PNG) from history
- **Review** — trust-first staging for ambiguous files
- **Watch folder** — optional; Downloads by default unless you aim elsewhere
- **Shortcuts** — Sort Files intent for routine chains
- **CLI (`binky`)** — same Organizer prefs/rules from Terminal (`docs/local-cli.md`); flock + `--json`; build via `swift build` in `BinkyCore`
- **History** — reveals and undo moves when the OS cooperates

## Licensing (planned 2.0)

- **1.x:** Free official builds; **MIT** source on GitHub.
- **2.0:** One-time license for **official** signed builds; **one year of updates** included; **optional** yearly renewal for more updates (not a subscription). FAQ: https://binkyfiles.com/#faq-licensing

## Rough comparison (not legal advice)

- **vs Hazel** — Hazel is the Mac routine rules engine everywhere. Binky is folder-first: watch, gate, sorted destinations, Review, Quick Sort when you just need calm now.
- **vs Dropzone 4** — Dropzone is drag-to-route shelf actions. Binky watches folders without you ferrying each file.
- **vs Unclutter** — Unclutter is a desktop drawer with a files shelf. Binky routes arrivals into destinations automatically.
- **vs CleanMyMac** — CleanMyMac scans and cleans the system. Binky sorts live drops into destinations you configured.
- **vs manual sorting** — Still free; your time isn't.

## Technical

- Apple Silicon (M-series Mac) only for distributed 1.x builds; Intel-based Macs are not supported
- Minimum **macOS 14 Sonoma**; Liquid Glass (`.glassEffect`) on **macOS 26 Tahoe** with material fallback on earlier releases
- Sister app **Dinky** ([dinkyfiles.com](https://dinkyfiles.com)) — media/PDF compression; current distributed builds require Apple Silicon and **macOS 15 Sequoia** or later
- SwiftUI + AppKit; dependency rules favor Apple frameworks ([project note](https://github.com/heyderekj/binky/blob/main/README.md))

## Network behavior

- **Update check:** once per day at most, the app requests GitHub’s public API for the latest release (`Binky/Services/UpdateChecker.swift`). No file paths or rules are sent.
- **Crash diagnostics:** optional in-app toggle; Apple’s MetricKit delivers payloads on-device. Nothing is transmitted until the user chooses email or a prefilled GitHub issue (`Binky/Services/DiagnosticsReporter.swift`).
- **No in-app telemetry:** no bundled analytics, crash-reporting SaaS, or ad SDKs. Marketing site **binkyfiles.com** uses Fathom for page analytics only; the app does not.

## Links

- Website: https://binkyfiles.com
- Support: help@binkyfiles.com
- GitHub: https://github.com/heyderekj/binky
- Latest release: https://github.com/heyderekj/binky/releases/latest
- Download v1.5.1: https://github.com/heyderekj/binky/releases/download/v1.5.1/Binky-1.5.1.dmg
- Homebrew: `brew tap heyderekj/binky https://github.com/heyderekj/binky` then `brew install --cask binky`

## Author

Derek Castelli — freelance designer (Webflow, Figma, Cursor)

- Website: https://heyderekj.com
- GitHub: https://github.com/heyderekj

## Agent integration

Marketing site only: **no public HTTP API**, **no OAuth/OIDC**, **no remote MCP server** on binkyfiles.com.

Discovery: https://binkyfiles.com/openapi.yaml, https://binkyfiles.com/.well-known/api-catalog, https://binkyfiles.com/.well-known/agent-skills/index.json, and this file.

**WebMCP** (where supported): the homepage registers `binky_scroll_to_faq`, `binky_open_install_modal`, `binky_copy_quarantine_command`, `binky_open_latest_release` via `navigator.modelContext.registerTool()`.