Skip to content

Latest commit

 

History

222 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

perch

drop it in the notch, drag it out anywhere

files, folders, images, links, and text, caught at the top of your screen until you know where they're going


You know the dance: drag a file, realise the destination window is buried, let go, dig it out, drag again.

Perch ends it. Start dragging anything, flick up to the notch, and a shelf drops down to catch it. Pile in as much as you like from as many places as you like, then grab any tile and drag the whole group to its real home in one motion. Copies in, copies out: your originals are never moved, renamed, or touched, nothing leaves the shelf on its own, and there's no Accessibility grant, no telemetry, and no Dock icon.

brew install --cask hausfold/tap/perch

macOS 14 or newer, signed and notarized. The phone half is free on the App Store — Perch Companion — and pairs by scanning the Mac's code, over your own network or with no network at all.

the manual

📖 hausfold.co/docs/perch — and it only lives there: install (which opens with the one macOS setting that steals the drop if you leave it on), using the shelf, and privacy, which is shorter than either.

Inside a haus machine it's the Shelf room — installed, themed and kept current with the rest of the desktop.

in this repo

  • docs/cli.mdperch add, its exit codes, and the mailbox protocol behind it
  • ai/SKILL.md — the agent surface, so "put this in my shelf" works first try
  • ARCHITECTURE.md — the invariants, and the seams that hold them
  • AGENTS.md — building it, testing it, shipping it

pre-release · built so the paths that could lose your files don't exist: copies in, copies out, clearing asks first. that's the intent, not a warranty; tell us what breaks.

⌂ hausfold

About

A native macOS file shelf that grows out of the MacBook notch.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages