Skip to main content

​
Download

Download the current public macOS build from the goldengoose launch page:

Download goldengoose for macOS

Get the latest public build and installation command.

​
Prerequisites

  • macOS (currently the best-supported platform)
  • At least one provider available:
    • OpenAI (the codex provider): sign in with ChatGPT or an API key in-app, or reuse an existing Codex CLI login
    • Claude (the claude provider): Claude CLI installed and signed in
    • OpenCode (the opencode provider, optional): OpenCode installed locally
For provider login details, see:

​
Install the public macOS build

  1. Download the app archive from goldengoose.ashray.xyz/download.
  2. Unpack it and move the app into /Applications: 
tar -xzf goldengoose.app.tar.gz
mv goldengoose.app /Applications/
  1. Clear the browser quarantine attribute once:
sudo xattr -cr /Applications/goldengoose.app
The current public build is unsigned and not Apple-notarized. The xattr command removes macOS quarantine metadata added by the browser download path. The app’s updater still verifies Tauri update signatures before installing updates. If macOS still blocks the app on first launch, open System Settings → Privacy & Security and choose Open Anyway for goldengoose.

​
Option 2: Run from source (contributors)

This is for development work on the app itself. Prerequisites:
  • Bun
  • Rust toolchain
git clone https://github.com/goldengoosedev/goldengoose.git
cd goldengoose
bun install
bun run dev

​
First run checklist

  1. Open a workspace folder (usually a Git repository).
  2. Create a new thread and pick a provider + model.
  3. Send a small first task, like “Summarize the repo structure” or “Fix this failing test”.
  4. Review tool activity in the timeline as the agent runs commands or edits files.
  5. Try a long-running command (tests, builds, installs) and watch it in the Process Monitor.
  6. (Optional) Create a team and add specialist members using model presets.

​
Next steps