# Binky

> A native macOS app for Downloads: watch the inbox, wait for files to settle, sort into buckets, route unknowns to Review. Pacifier calm, pacifier blunt. Runs locally.

## What it does

- **Sort Downloads Now** — batch sort with summaries; collision-safe renaming when names collide
- **Stable-file gate** — avoids grabbing half-downloaded noise
- **Buckets** — Images, PDFs, Media, Documents, Archives, Apps, Screenshots, Misc
- **Review** — trust-first staging for ambiguous files
- **Profiles** — per-profile destinations and sorting rules
- **Watch inbox** — optional; Downloads by default unless you aim elsewhere
- **Finder Quick Action** — “Sort with Binky” without opening the app
- **Shortcuts** — Sort Files intent for automation chains
- **Optional Finder tags** — on route when you want them
- **History** — reveals and undo moves when the OS cooperates

## Rough comparison (not legal advice)

- **vs Hazel** — Hazel is the Mac automation rules engine everywhere. Binky is Downloads-first organizer speak: watch, gate, buckets, Review.
- **vs Spring Cleaner** — Spring Cleaner clears cruft on a schedule. Binky routes live arrivals into piles you configured.
- **vs manual sorting** — Still free; your time isn't.

## Technical

- Minimum **macOS 14 Sonoma**; Liquid Glass (`.glassEffect`) on **macOS 26 Tahoe** with material fallback on earlier releases
- SwiftUI + AppKit; dependency rules favor Apple frameworks ([project note](https://github.com/heyderekj/binky/blob/main/README.md))

## Links

- Website: https://binkyfiles.com
- Support: help@binkyfiles.com
- GitHub: https://github.com/heyderekj/binky
- Latest release: https://github.com/heyderekj/binky/releases/latest
- 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()`.