Skip to content

Perch v0.0.1

Choose a tag to compare

View all tags
@CarolaneLFBV CarolaneLFBV released this 08 Aug 12:26
· 6 commits to main since this release
v0.0.1
883df37
This commit was signed with the committer’s verified signature.
CarolaneLFBV Carolane Lefebvre
SSH Key Fingerprint: dY4/j7bsQUZ+DPX0H01YJFUbA+vqFM5hgIhI6iG4foE
Verified
Learn about vigilant mode.

Perch shows the state of Xcode's built-in Claude agent in the notch of a MacBook Pro.

Idle, there is nothing — the notch goes back to being a notch. The moment the agent works, two hairlines frame it, and hovering unfolds a panel: project, branch, model, context in use, session token totals, conversation title, Xcode run destination, and the last tools called.

Requirements

  • macOS 14 or later
  • A Mac with a notch (on a notchless display Perch stays silent)
  • Xcode's built-in Claude agent, which must have run at least once
  • A Swift 6 toolchain

Install

No binary is attached, on purpose: the build signs ad hoc, so a downloaded .app would be refused by Gatekeeper. Build it yourself instead — there are no external dependencies.

git clone https://github.com/CarolaneLFBV/Perch.git
cd Perch
bash Scripts/bundle.sh && open build/Perch.app

The bundle is not optional: it carries the NSAppleEventsUsageDescription key, without which macOS kills the process on the first Apple Event sent to Xcode.

In this release

  • Read-only throughout: transcripts are opened read-only and watched with an O_EVTONLY descriptor, only metadata is decoded, nothing is persisted, logged or sent anywhere
  • An About window with the version, a language selector and a Quit button
  • Interface localised in 11 languages — English, French, German, Spanish, Italian, Brazilian Portuguese, Dutch, Japanese, Simplified Chinese, Korean, Russian
  • perch-cli, a one-pass diagnostic whose output is safe to paste into a public issue
  • 84 tests, strict concurrency, CI that also assembles the bundle

Translations for languages the author does not read went out without a native reviewer. Corrections are very welcome: one file per language under Sources/Perch/Resources/<code>.lproj/.

Assets 2
Loading