> ## Documentation Index
> Fetch the complete documentation index at: https://goldengoose.zue.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Quickstart (Install)

> Install goldengoose and run your first session.

## Download

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

<Card title="Download goldengoose for macOS" href="https://goldengoose.ashray.xyz/download">
  Get the latest public build and installation command.
</Card>

## 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:

* [Auth: OpenAI](/auth/openai)
* [Auth: Claude](/auth/claude)
* [Auth: OpenCode](/auth/opencode)

## Install the public macOS build

1. Download the app archive from [goldengoose.ashray.xyz/download](https://goldengoose.ashray.xyz/download).

2. Unpack it and move the app into `/Applications`:

```bash theme={null}
tar -xzf goldengoose.app.tar.gz
mv goldengoose.app /Applications/
```

3. Clear the browser quarantine attribute once:

```bash theme={null}
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

```bash theme={null}
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

* Learn how gg tools work: [gg Tools](/how-it-works/gg-tools)
* Understand teams and messaging: [Communication System](/how-it-works/communication-system)
* Get faster with the UI: [Keyboard Shortcuts](/how-it-works/keyboard-shortcuts)