Reading the repo

Opening the box…

Assembly instructions

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,231
Activity: Updated this month
License: Apache-2.0
Open issues: 557
Got it running: Be the first
Looked up: 2 h ago

Saved setup from 2 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

Download for macOS

v1.57.0 · 10/28/2026 ↗

Goose-darwin-arm64.zip

zip · Apple Silicon · 182.5 MB · 217 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 · 331 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 · 618 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 · 90 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,229 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 · 207 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 · 99 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,223 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 · 631 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? Get a written guide

Claude reads the 13 key files and writes a step-by-step guide for macOS. Once written, it's saved for everyone.

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_TOKENsecret
CODEBASE_PATH

Share this manual

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,580 files in the repo