Repository navigation
Guaca v0.3.0
What's new
- Signal refreshes the workspace, with a theme picker and a composer that names its fixed recipient. Selecting another recipient moves the draft to that agent's channel.
- Settings → Permissions adds allow and block rules for protected actions.
- A host can sign in to Claude or ChatGPT using its own provider credentials.
- The connecting screen has a deadline and a host chooser if a saved connection cannot be reached.
- The self-hosted Google connector broker supports an operator-owned Google OAuth client. Source installs pull the verified matching host image when available.
- Onboarding, the transcript, agent inspector and connection recovery have been refined.
Installation and migration
The universal disk image supports Apple silicon and Intel Macs. On this Mac requires Docker; connecting to a remote host requires a reachable compatible host. The desktop download does not require Node, Rust or a source checkout.
Back up your workspace before upgrading. The upgrade runs database migrations. The coding subsystem, including its terminal and coding tools, has been removed. Its database session and tuning records are dropped; terminal directories on disk are left untouched. Agents that need a shell can use a computer with run_command.
For an existing host, update the host to the matching release before using new desktop features. Provider sign-ins belong to the host and may need to be set up there. Google connector self-hosting requires your own OAuth client and broker configuration.
Build and verification
- Source:
4394b3c8d8f78b11888206328fcdf71ecb99ac4a. - Backend:
ghcr.io/madebywelch/guaca/guacad@sha256:459b2df9534bf0ac080ffc45841d5739bfea42e586827ed13b1a508e411f6a06. - The full macOS verification gate passed: 2,321 frontend tests, 3,422 Rust test results passed with 56 ignored, and 3 Google connector tests. The backend image test passed.
- Both Linux arm64 and amd64 images were pulled without registry credentials.
- The universal app and disk image were signed with Developer ID, notarized by Apple, and checked with Gatekeeper. The disk image and the separate build-directory app were stapled and validated.
- The mounted app passed signature and Gatekeeper checks on Apple silicon. An Intel launch and end-to-end provider sign-in and host setup were not tested in this release run.