Reading the repo

Opening the box…

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

How to install on Linux

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 Linux

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

Checking for

macOS Windows Linux

Download for Linux

v1.57.0 · 10/28/2026 ↗

goose_1.57.0_amd64.deb

deb · x64 · 146.5 MB · 1,084 downloads · best match

Download

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/goose_1.57.0_amd64.deb"
sudo apt install ./"goose_1.57.0_amd64.deb"

Other Linux downloads (25)

goose_1.57.0_amd64-vulkan.deb

deb · x64 · 149.4 MB · 767 downloads

Download

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/goose_1.57.0_amd64-vulkan.deb"
sudo apt install ./"goose_1.57.0_amd64-vulkan.deb"

goose-acp-x86_64-unknown-linux-gnu.tar.gz

tar.gz · x64 · 10.5 MB · 383 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

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

goose-x86_64-unknown-linux-gnu-vulkan.tar.gz

tar.gz · x64 · 71.3 MB · 38 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/goose-x86_64-unknown-linux-gnu-vulkan.tar.gz"
tar -xzf "goose-x86_64-unknown-linux-gnu-vulkan.tar.gz"

goose-x86_64-unknown-linux-gnu.tar.gz

tar.gz · x64 · 62.3 MB · 12,064 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

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

goose-x86_64-unknown-linux-musl.tar.gz

tar.gz · x64 · 50.1 MB · 1,022 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

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

goose_1.57.0_arm64-vulkan.deb

deb · ARM64 · 146.4 MB · 33 downloads

Download

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/goose_1.57.0_arm64-vulkan.deb"
sudo apt install ./"goose_1.57.0_arm64-vulkan.deb"

goose_1.57.0_arm64.deb

deb · ARM64 · 143.2 MB · 69 downloads

Download

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/goose_1.57.0_arm64.deb"
sudo apt install ./"goose_1.57.0_arm64.deb"

Goose-1.57.0-1.x86_64-vulkan.rpm

rpm · x64 · 156.7 MB · 55 downloads

Download

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/Goose-1.57.0-1.x86_64-vulkan.rpm"
sudo dnf install ./"Goose-1.57.0-1.x86_64-vulkan.rpm"

Goose-1.57.0-1.x86_64.rpm

rpm · x64 · 152.8 MB · 1,131 downloads

Download

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/Goose-1.57.0-1.x86_64.rpm"
sudo dnf install ./"Goose-1.57.0-1.x86_64.rpm"

goose-aarch64-unknown-linux-gnu-vulkan.tar.gz

tar.gz · ARM64 · 72.3 MB · 23 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/goose-aarch64-unknown-linux-gnu-vulkan.tar.gz"
tar -xzf "goose-aarch64-unknown-linux-gnu-vulkan.tar.gz"

goose-aarch64-unknown-linux-gnu.tar.gz

tar.gz · ARM64 · 63.1 MB · 3,087 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

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

goose-acp-aarch64-unknown-linux-gnu.tar.gz

tar.gz · ARM64 · 10.0 MB · 237 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

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

goose-aarch64-unknown-linux-musl.tar.gz

tar.gz · ARM64 · 48.7 MB · 441 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

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

Goose-1.57.0-1.arm64-vulkan.rpm

rpm · ARM64 · 146.6 MB · 46 downloads

Download

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/Goose-1.57.0-1.arm64-vulkan.rpm"
sudo dnf install ./"Goose-1.57.0-1.arm64-vulkan.rpm"

Goose-1.57.0-1.arm64.rpm

rpm · ARM64 · 142.6 MB · 661 downloads

Download

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/Goose-1.57.0-1.arm64.rpm"
sudo dnf install ./"Goose-1.57.0-1.arm64.rpm"

io.github.block.Goose_stable_x86_64-vulkan.flatpak

flatpak · x64 · 141.9 MB · 47 downloads

Download

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/io.github.block.Goose_stable_x86_64-vulkan.flatpak"
flatpak install ./"io.github.block.Goose_stable_x86_64-vulkan.flatpak"

io.github.block.Goose_stable_x86_64.flatpak

flatpak · x64 · 137.8 MB · 506 downloads

Download

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/io.github.block.Goose_stable_x86_64.flatpak"
flatpak install ./"io.github.block.Goose_stable_x86_64.flatpak"

goose-x86_64-unknown-linux-gnu-vulkan.tar.bz2

tar.bz2 · x64 · 61.7 MB · 38 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/goose-x86_64-unknown-linux-gnu-vulkan.tar.bz2"
tar -xjf "goose-x86_64-unknown-linux-gnu-vulkan.tar.bz2"

goose-x86_64-unknown-linux-gnu.tar.bz2

tar.bz2 · x64 · 55.7 MB · 5,743 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

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

goose-x86_64-unknown-linux-musl.tar.bz2

tar.bz2 · x64 · 43.3 MB · 303 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

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

io.github.block.Goose_stable_aarch64-vulkan.flatpak

flatpak · ARM64 · 131.6 MB · 19 downloads

Download

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/io.github.block.Goose_stable_aarch64-vulkan.flatpak"
flatpak install ./"io.github.block.Goose_stable_aarch64-vulkan.flatpak"

io.github.block.Goose_stable_aarch64.flatpak

flatpak · ARM64 · 128.5 MB · 23 downloads

Download

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/io.github.block.Goose_stable_aarch64.flatpak"
flatpak install ./"io.github.block.Goose_stable_aarch64.flatpak"

goose-aarch64-unknown-linux-gnu-vulkan.tar.bz2

tar.bz2 · ARM64 · 61.6 MB · 29 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/goose-aarch64-unknown-linux-gnu-vulkan.tar.bz2"
tar -xjf "goose-aarch64-unknown-linux-gnu-vulkan.tar.bz2"

goose-aarch64-unknown-linux-gnu.tar.bz2

tar.bz2 · ARM64 · 55.4 MB · 1,023 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

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

goose-aarch64-unknown-linux-musl.tar.bz2

tar.bz2 · ARM64 · 42.6 MB · 258 downloads

Download

Move the extracted binary onto your PATH (e.g. /usr/local/bin).

curl -LO "https://github.com/aaif-goose/goose/releases/download/v1.57.0/goose-aarch64-unknown-linux-musl.tar.bz2"
tar -xjf "goose-aarch64-unknown-linux-musl.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 Linux yet.

Still stuck? Ask an AI

Opens a chat with this manual already filled in, for Linux. 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