Reading the repo

Opening the box…

How to install goose on macOS (aaif-goose/goose) · gitmanual

How to install on macOS

aaif-goose/goose

an open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM

Rust#acp#ai#ai-agents#mcp

Difficulty: Easy
Time: about 5 min
Stars: ★ 56,273
Activity: Updated this month
License: Apache-2.0
Open issues: 558
Got it running: Be the first
Looked up: 16 h ago

GitHub didn't answer, so this is the saved copy from 16 h ago

Start here

Website ↗goose-docs.aiThe project's own site.Docs ↗goose-docs.aiLinked from the README.In the browser ↗Open in GitHub CodespacesThe repo ships a dev container, so nothing to install.

Will it work on my device?

Yes, it installs on your macOS

A ready-made macOS download is in the latest release.

Checking for

macOS Windows Linux

Download for macOS

v1.57.0 · 10/28/2026 ↗

Goose-darwin-arm64.zip

zip · Apple Silicon · 182.5 MB · 241 downloads · best match

Download

If it contains an .app, move it to Applications.

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/Goose-darwin-arm64.zip"
unzip "Goose-darwin-arm64.zip"

Other macOS downloads (8)

goose-aarch64-apple-darwin.tar.gz

tar.gz · Apple Silicon · 56.5 MB · 368 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/goose-aarch64-apple-darwin.tar.gz"
tar -xzf "goose-aarch64-apple-darwin.tar.gz"

goose-acp-aarch64-apple-darwin.tar.gz

tar.gz · Apple Silicon · 8.9 MB · 779 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/goose-acp-aarch64-apple-darwin.tar.gz"
tar -xzf "goose-acp-aarch64-apple-darwin.tar.gz"

Goose-darwin-x64.zip

zip · Intel · 192.3 MB · 96 downloads

Download

If it contains an .app, move it to Applications.

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/Goose-darwin-x64.zip"
unzip "Goose-darwin-x64.zip"

Goose_intel_mac.zip

zip · Intel · 192.3 MB · 1,418 downloads

Download

If it contains an .app, move it to Applications.

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/Goose_intel_mac.zip"
unzip "Goose_intel_mac.zip"

goose-acp-x86_64-apple-darwin.tar.gz

tar.gz · Intel · 9.6 MB · 236 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/goose-acp-x86_64-apple-darwin.tar.gz"
tar -xzf "goose-acp-x86_64-apple-darwin.tar.gz"

goose-x86_64-apple-darwin.tar.gz

tar.gz · Intel · 58.7 MB · 107 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/goose-x86_64-apple-darwin.tar.gz"
tar -xzf "goose-x86_64-apple-darwin.tar.gz"

goose-aarch64-apple-darwin.tar.bz2

tar.bz2 · Apple Silicon · 51.0 MB · 1,427 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/goose-aarch64-apple-darwin.tar.bz2"
tar -xjf "goose-aarch64-apple-darwin.tar.bz2"

goose-x86_64-apple-darwin.tar.bz2

tar.bz2 · Intel · 52.3 MB · 722 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin). If macOS blocks it: xattr -d com.apple.quarantine <binary>

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/goose-x86_64-apple-darwin.tar.bz2"
tar -xjf "goose-x86_64-apple-darwin.tar.bz2"

Install with a package manager

install script

curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash

Pipes a remote script into your shell. Read it before running.

From the README, exactly as the maintainers wrote it.

Did you get it running?

No reports for macOS yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for macOS. It uses your own account; gitmanual sends nothing.

Ask Claude Ask ChatGPT

Parts list

1×Rust 1.99.0runtime

9× settings in .env

DISCORD_TOKENsecret
DISCORD_APP_ID
QUESTION_CHANNEL_ID
ANTHROPIC_API_KEYsecret
AI_MODEL
CONSOLA_LEVEL
DOCS_PATH
GITHUB_TOKENsecretoptional
CODEBASE_PATH

Share this manual

Is this your repo?

Add a badge to your README so newcomers find these steps.

[![Setup manual](https://gitmanual.com/aaif-goose/goose/badge.svg)](https://gitmanual.com/aaif-goose/goose)

Good to know

Cargo workspace — pick a crate with cargo run -p <name>.
Dockerfile available (base image: rust:1.82-bookworm).
Dev Container config found — you can open it in VS Code Dev Containers or GitHub Codespaces for a zero-setup environment.
Has AGENTS.md — instructions for coding agents. You can open Claude Code (or another agent) in the cloned folder and ask it to do the setup for you.
Nested projects: crates/goose-acp-macros/Cargo.toml, crates/goose-agent/Cargo.toml, crates/goose-cli/Cargo.toml, crates/goose-context-management/Cargo.toml and 11 more

Files we read (13)

.devcontainer/devcontainer.json

.github/workflows/build-acp.yml

.github/workflows/build-cli-linux.yml

.github/workflows/build-notify.yml

.github/workflows/check-release-pr.yaml

.github/workflows/ci.yml

.github/workflows/pr-smoke-test.yml

CONTRIBUTING.md

Cargo.toml

Dockerfile

README.md

rust-toolchain.toml

services/ask-ai-bot/.env.example

Branch main · 2,581 files in the repo