Puck for macOS 0.1.0

The first release of Puck for macOS — a desktop pet that is also an AI agent.

Two apps that ship together and talk to each other over a local socket:

• Puck — the pet: an always-on-top character that walks your screen, climbs
  your windows, points at things, listens for voice, and drives the Mac
  (run_shell, run_applescript, click/find UI elements, launch apps).
• PuckClient — its window: chat, workspaces, git status, a native SwiftUI
  code editor, and a terminal pane.

Install

Download Puck-0.1.0.dmg below and drag both apps into Applications. macOS 14
or newer.

The image is signed ad-hoc rather than with a Developer ID, so the first launch
is refused as coming from an unidentified developer: right-click the app →
Open → Open, once per app. Puck then asks for Accessibility, and for the
microphone, speech recognition and screen recording as you use the features that
need them.

Building from source instead is sh pet-app/scripts/install.sh — see the README.

Connect an AI

Chat talks to the Anthropic or OpenAI API directly. The code_editor tool runs
a vendored ACP agent under node, which needs its vendor's CLI (claude or
codex). Keys go in ~/Library/Application Support/Puck/.env.

Make it your own

An avatar is a folder with a manifest.json and one PNG per clip — one drawing
is already a working character. Drop a seabed.png into Tank/ to change what
the island is filled with. The full format is in the
README.

---

macOS용 Puck의 첫 릴리즈입니다. 아래 Puck-0.1.0.dmg를 받아 두 앱을 응용 프로그램
폴더에 넣으세요 (macOS 14 이상). ad-hoc 서명이라 첫 실행은 "확인되지 않은 개발자"로
거부됩니다 — 앱을 우클릭 → 열기 → 열기를 앱마다 한 번씩. 한국어 안내는
README.ko.md에
있습니다.