2025-02-21 18:23:03 -06:00
<div align="center">
2024-08-23 16:39:04 -07:00
2025-09-14 01:11:05 -05:00
# goose
2025-02-21 18:23:03 -06:00
2026-04-07 17:18:04 +10:00
_ your native open source AI agent — desktop app, CLI, and API — for code, workflows, and everything in between _
2024-08-23 16:39:04 -07:00
<p align="center">
2026-02-18 21:29:13 -05:00
<a href="https://opensource.org/licenses/Apache-2.0"
><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg"></a>
2026-08-01 00:49:19 +02:00
<a href="https://discord.gg/n8R5VaWDAn"
2026-02-18 21:29:13 -05:00
><img src="https://img.shields.io/discord/1287729918100246654?logo=discord&logoColor=white&label=Join+Us&color=blueviolet" alt="Discord"></a>
2026-04-07 01:34:48 -04:00
<a href="https://github.com/aaif-goose/goose/actions/workflows/ci.yml"
><img src="https://img.shields.io/github/actions/workflow/status/aaif-goose/goose/ci.yml?branch=main" alt="CI"></a>
2026-04-20 16:27:13 -04:00
<a href="https://insights.linuxfoundation.org/project/goose"><img src="https://insights.linuxfoundation.org/api/badge/health-score?project=goose"></a>
2026-05-22 12:24:47 -04:00
<a href="https://repology.org/project/goose-cli/versions"><img src="https://repology.org/badge/tiny-repos/goose-cli.svg" alt="Packaging status"></a>
2024-08-23 16:39:04 -07:00
</p>
2026-07-09 15:25:58 -05:00
<a href="https://trendshift.io/repositories/25298?utm_source=repository-badge&utm_medium=badge&utm_campaign=badge-repository-25298" target="_blank" rel="noopener noreferrer"><img src="https://trendshift.io/api/badge/repositories/25298" alt="aaif-goose%2Fgoose | Trendshift" width="250" height="55"/></a>
2025-02-21 18:23:03 -06:00
</div>
2026-07-09 15:25:58 -05:00
2026-04-07 17:18:04 +10:00
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 ](https://goose-docs.ai/docs/guides/acp-providers ). Connect to 70+ extensions via the [Model Context Protocol ](https://modelcontextprotocol.io/ ) open standard.
goose is part of the [Agentic AI Foundation (AAIF) ](https://aaif.io/ ) at the Linux Foundation.
# Get started
2025-02-21 18:23:03 -06:00
2026-04-07 17:18:04 +10:00
* * [Download the desktop app ](https://goose-docs.ai/docs/getting-started/installation )** for macOS, Linux, and Windows.
2025-02-21 18:23:03 -06:00
2026-04-07 17:18:04 +10:00
Or install the CLI:
2024-08-23 16:39:04 -07:00
2026-04-07 17:18:04 +10:00
``` bash
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash
```
2025-09-07 23:19:52 -05:00
2026-04-07 17:18:04 +10:00
# Quick links
2026-04-07 01:34:48 -04:00
- [Quickstart ](https://goose-docs.ai/docs/quickstart )
- [Installation ](https://goose-docs.ai/docs/getting-started/installation )
- [Tutorials ](https://goose-docs.ai/docs/category/tutorials )
- [Documentation ](https://goose-docs.ai/docs/category/getting-started )
- [Governance ](https://github.com/aaif-goose/goose/blob/main/GOVERNANCE.md )
2026-04-07 17:18:04 +10:00
- [Custom Distributions ](https://github.com/aaif-goose/goose/blob/main/CUSTOM_DISTROS.md ) — build your own goose distro with preconfigured providers, extensions, and branding
2025-01-27 19:46:34 -08:00
2026-04-07 17:18:04 +10:00
## Need help?
2026-04-07 01:34:48 -04:00
- [Diagnostics & Reporting ](https://goose-docs.ai/docs/troubleshooting/diagnostics-and-reporting )
- [Known Issues ](https://goose-docs.ai/docs/troubleshooting/known-issues )
2025-11-02 14:19:47 -05:00
2026-02-26 20:29:34 +01:00
# a little goose humor 🪿
2025-09-05 11:49:26 +10:00
> Why did the developer choose goose as their AI agent?
>
> Because it always helps them "migrate" their code to production! 🚀
2026-04-07 17:18:04 +10:00
# goose around with us
2026-08-01 00:49:19 +02:00
- [Discord ](https://discord.gg/n8R5VaWDAn )
2025-09-07 19:30:48 -05:00
- [YouTube ](https://www.youtube.com/@goose-oss )
- [LinkedIn ](https://www.linkedin.com/company/goose-oss )
- [Twitter/X ](https://x.com/goose_oss )