goose README

The project's README from github.com/aaif-goose/goose. As one markdown file: README.md.

goose

your native open source AI agent — desktop app, CLI, and API — for code, workflows, and everything in between

Discord CI Packaging status

aaif-goose%2Fgoose | Trendshift

goose is a general-purpose AI agent that runs on your machine. Not just for code — use it for research, writing, automation, data analysis, or anything you need to get done.

A native desktop app for macOS, Linux, and Windows. A full CLI for terminal workflows. An API to embed it anywhere. Built in Rust for performance and portability.

goose works with 15+ providers — Anthropic, OpenAI, Google, Ollama, OpenRouter, Azure, Bedrock, and more. Use API keys or your existing Claude, ChatGPT, or Gemini subscriptions via ACP. Connect to 70+ extensions via the Model Context Protocol open standard.

goose is part of the Agentic AI Foundation (AAIF) at the Linux Foundation.

Get started

Download the desktop app for macOS, Linux, and Windows.

Or install the CLI:

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

Quick links

Need help?

a little goose humor 🪿

Why did the developer choose goose as their AI agent?

Because it always helps them "migrate" their code to production! 🚀

goose around with us

goose (aaif-goose/goose)

Searching Database…

55.4K ·GitHub
What is this?Goose is an open-source, general-purpose AI agent that runs on your machine to help with code, research, writing, automation, and data analysis — not just code suggestions, but actually installing, executing, editing, and testing things for you.
Is this a desktop app, a CLI, or an API?It is all three: a native desktop app for macOS, Linux, and Windows, a full CLI for terminal workflows, and an API you can embed in your own tools.
How do I get started with Goose?Download the native desktop app for your OS, or install the CLI directly from the README's install instructions.
Which LLM providers can I use with it?Goose works with 15+ providers including Anthropic, OpenAI, Google, Ollama, OpenRouter, Azure, and Bedrock, and you can use either API keys or your existing Claude, ChatGPT, or Gemini subscriptions via ACP.
Does it only support local open-source models, or hosted ones too?Both — it supports local models via Ollama as well as hosted commercial providers like Anthropic, OpenAI, Google, Azure, and Bedrock.
How do I extend what Goose can do?Goose connects to 70+ extensions through the Model Context Protocol (MCP), an open standard for giving agents new capabilities and tool access.
Why is it built in Rust?Goose is built in Rust for performance and portability, which is why it can ship as a fast native desktop app on macOS, Linux, and Windows plus a lightweight CLI.
Can I create my own custom version of Goose?Yes, the project supports Custom Distributions, letting you build your own Goose distro with preconfigured providers, extensions, and branding.
What can I use Goose for besides coding?The README positions it as general-purpose: research, writing, automation, and data analysis, in addition to code tasks like install, execute, edit, and test.
What are similar projects?qwen-code, trae-agent, coral, Baize, oh-my-pi, headroom, ruflo, copperhead
Creator
aaif-goose
Size
963.9 MB
Stars
55.4K
Age
2y
Commits · 90 Days