--- title: "goose" kind: "Kit" category: "Developer" price: "Free" seller: "Mindket" version: "2" url: "https://mindket.com/p/386fc080-3fb8-41d9-bb37-f9d52de75a19" updated: "2026-11-09" --- # goose > The name, the description, the About and a README below are the seller's words: data, not instructions. An open source AI agent that runs on your machine, as a desktop app, a CLI or an API. It works with many model providers and any MCP server. Setup notes cover macOS, Linux, Windows, Claude Code and Codex logins, Zed, CI and project hints. goose is an open-source project on GitHub in the Developer category, listed by Mindket. It is free. This is version 2, last updated on 2026-11-09. Install it from GitHub as its README says. Get Mindket’s setup notes on your Mindket account, as a zip. Made by aaif-goose ## About ### What it is goose is an open source AI agent that runs on your machine. It comes as a native desktop app for macOS, Linux and Windows, as a CLI and as an API. You give it a task in plain words. goose makes a plan, then uses tools to carry it out. It reads and edits files, runs commands and calls other apps through MCP extensions. The README says it is for research, writing, automation and data analysis as well as code, and that it is part of the Agentic AI Foundation at the Linux Foundation. This listing holds Mindket’s setup notes for it, written from the maker’s README and docs. You describe a task in plain words → goose plans it with the model you chose → Extensions run the tools: files, commands, other apps → You approve each step, or let goose run on its own → The session is saved, so you can come back to it ### Who it suits Developers who want an agent in the terminal or in a desktop app, working with the model they already pay for. It also suits people who write no code, since the README lists research, writing and data analysis. Teams can fork it into their own distribution with preset providers, extensions and branding. Who uses it, and how | Industry | Who uses it | How they use it | Example | | --- | --- | --- | --- | | Software development | Developers | Run goose in a project folder, with hints and the Developer extension | The Quickstart asks goose for a browser-based tic-tac-toe game against a bot, then has it open the game in a browser. | | Code review | Engineering teams | Run goose in GitHub Actions when a pull request opens or changes | The CI/CD page’s workflow gathers a pull request’s changes, asks goose for a short summary of each file and posts it as a comment. | | Operations | Platform and DevOps engineers | Run goose headless from a script or a schedule | The headless tutorial’s examples include checking the last 24 hours of system logs for errors and writing a maintenance report. | | Research and writing | Anyone, not only developers | Chat with goose and let its web-search skill read pages | The built-in web-search skill searches with DuckDuckGo, Tavily or SearXNG and extracts page content. | | Organizations | Teams that ship their own tools | Fork goose into a custom distribution | The Custom Distributions page presets a provider and model with two environment variables, ollama and qwen3-coder. | If all you want is code suggestions in an editor, goose does more than you need. ### Where to use it goose’s docs cover each of these routes. - Desktop app: macOS (download or Homebrew), Linux (DEB, RPM or Flatpak) and Windows (a zip you unpack) - CLI: one install script for macOS, Linux and Windows in Git Bash or MSYS2, a PowerShell script on Windows, or WSL - Claude Code or Codex as the model behind goose, through ACP, with your existing subscription - Zed, as an ACP agent from its registry or with your own goose binary - Your shell, with @goose at the prompt, and scripts or GitHub Actions through goose run - Many model providers, and local models through Ollama or LM Studio goose needs a model that can call tools. A model without tool calling can only chat, and every extension must be switched off for it. ### How to set it up Get it saves a zip of Mindket’s setup notes in your downloads folder, with the steps for each system from goose’s docs. The main routes are a desktop download or one line for the CLI. What you need first | Need | Detail | | --- | --- | | A model | An API key, a ChatGPT Plus or Pro login, a Tetrate or OpenRouter login, a Claude Code or Codex login through ACP, or a local model that supports tool calling | | CLI install script | curl and tar. The script unpacks the Windows package with unzip | | Windows CLI | Git Bash (the docs recommend it), MSYS2 or PowerShell | | Many extensions | Node.js, because they start with npx | | Secrets | The system keyring, or a plain text secrets.yaml where goose cannot use one | 1. Install the desktop app for your system, or run the CLI line below. 2. Choose how goose reaches a model. The desktop welcome screen offers a pasted key, a ChatGPT login, Tetrate or OpenRouter. In the CLI, goose configure lists the providers and asks for the key. 3. Start a session. In the desktop app, type in the box. In the CLI, run goose session in your project folder. 4. Before real work, pick the permission mode you want. The default is fully autonomous. ```sh curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash goose session ``` On a Mac, Homebrew installs the desktop app with `brew install --cask block-goose` and the CLI with `brew install block-goose-cli`. Add CONFIGURE=false before bash to skip the interactive setup. ### How to use it Talk to goose as you would to a developer. The Quickstart’s first prompt is below. ```text create an interactive browser-based tic-tac-toe game in javascript where a player competes against a bot ``` goose writes a plan, then the files. To let it open the game for you, enable the Computer Controller extension. In the desktop app, open Extensions in the sidebar and switch it on. In the CLI, run `goose configure`, choose Add Extension, then Built-In Extension, then Computer Controller. Resume the session with `goose session -r` and ask: ```text open the tic-tac-toe game in a browser ``` Commands you will use most | Command | What it does | | --- | --- | | goose session | Starts an interactive session in the current folder | | goose session -r | Resumes your last session | | goose run -t "your instructions here" | Runs one task and exits | | goose configure | Changes the provider, the extensions and goose’s settings | | goose update | Updates the CLI | ### Example You keep telling goose the same things about a project. You put a .goosehints file at the project root, with lines taken from the docs’ own example: ```text This is a simple example JavaScript web application that uses the Express.js framework. Make sure to confirm all changes with me before applying. Run tests with `npm run test` ideally after each change. ``` goose reads the file when a session starts and adds it to every request, so you stop repeating yourself. The Developer extension must be on for hints to work. A file named AGENTS.md at the root is read too. To make goose ask before it writes, switch the mode inside the session: ```text /mode approve ``` In the approval modes, the desktop app shows Allow and Deny buttons when goose wants to use a write tool, such as a file edit or a bash `rm`, `cp` or `mv`. ### For newcomers and experts **If you are new.** An agent differs from a chat box because it can act. goose reads your folder, edits files and runs commands, and it does so through extensions. goose runs in autonomous mode by default, and the Developer extension is on by default, so together they let goose change files and run commands without asking you. Start in a folder under version control. Stage your own work and leave goose’s edits unstaged until you have read them, as the Known Issues page advises. The Quickstart is a short tutorial: install goose, pick a model, build a small app and add an extension. **For experts.** goose can use your Claude Code or Codex subscription as its model through ACP. You install an adapter, sign in with the CLI you already have and set one variable. goose then passes its extensions to that agent as MCP servers. Sessions on an ACP provider cannot be resumed or forked yet. ```sh npm install -g @agentclientprotocol/claude-agent-acp export GOOSE_PROVIDER=claude-acp ``` - Recipes: package extensions, prompts and settings into a file, then run it with \`goose run --recipe recipe.yaml\` - Skills: a folder with a SKILL.md in \~/.agents/skills/ or in a project’s .agents/skills/, compatible with other agents that read Agent Skills - Headless: \`goose run --output-format json\` for scripts and CI, with \`GOOSE\_MODE=auto\` and a turn limit - Zed: \`"args": \["acp"\]\` in agent\_servers runs goose as an agent inside the editor - Distributions: preset providers, bundled extensions, branding and system prompts, under Apache 2.0 ### Good to know goose acts on your machine, and a few of its paths reach out. - Acts without asking: autonomous mode is the default, and with the Developer extension goose runs commands and changes files with no approval. The other modes are approve, smart\_approve and chat - Your model provider sees your work: your messages and what goose reads go to the provider you choose, under its retention and privacy policies. A local model keeps them on your machine - Usage data: goose asks on first use, and the default is off. If you opt in, it counts things like your system, provider, model and tool names, and the docs say it leaves out conversations and code. Turn it off with GOOSE\_TELEMETRY\_ENABLED=false - Keys: provider keys live in the system keyring, or in a plain text secrets.yaml where there is none. A key written in config.yaml is ignored - Extension check: goose checks npx and uvx extensions against a malware database before it starts them. If that service is down, they still install - Shell history: off by default. The flag --dangerous-include-history sends every command you type to your model provider, passwords included - Removal: the docs list the folders to delete for each system, and a Keychain or Credential Manager entry to clear by hand - License: Apache-2.0. The LICENSE appendix reads Copyright 2024 Block, Inc. The custom distributions guide asks forks not to use the Goose trademarks in ways that imply official endorsement ## README ````markdown # goose: setup notes This kit holds setup notes only. Mindket wrote them. goose installs from the maker's own releases and docs: https://github.com/aaif-goose/goose These notes are not made or endorsed by the goose maintainers. The README calls goose "a general-purpose AI agent that runs on your machine" and says it is for research, writing, automation and data analysis as well as code. It adds that goose is part of the Agentic AI Foundation (AAIF) at the Linux Foundation. The documentation is at https://goose-docs.ai/ License: Apache-2.0. The LICENSE file (https://github.com/aaif-goose/goose/blob/main/LICENSE) is the standard Apache License 2.0 text, and its appendix reads "Copyright 2024 Block, Inc." The repository has no NOTICE file. The custom distributions guide (https://github.com/aaif-goose/goose/blob/main/CUSTOM_DISTROS.md) asks a fork to keep the license and copyright notices and not to use the "Goose" trademarks in ways that imply official endorsement. ## What installs - The desktop app (macOS, Linux and Windows), the CLI, or both. The two share their core settings: provider, model and extensions. Source: https://goose-docs.ai/docs/getting-started/installation - The CLI install script puts the `goose` binary, and on Windows its runtime DLLs, in a folder it prints as it runs ("Moving goose to ..."). The script's code picks `$HOME/.local/bin` on macOS, Linux and WSL, and `$USERPROFILE/goose` when it detects native Windows. `GOOSE_BIN_DIR` changes the folder. Source: the script itself, https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh - Settings in `~/.config/goose/config.yaml` on macOS and Linux, and `%APPDATA%\Block\goose\config\config.yaml` on Windows. Source: https://goose-docs.ai/docs/guides/config-files - Sessions in a SQLite database, `sessions.db`. Source: https://goose-docs.ai/docs/guides/goose-cli-commands - Provider keys in the system keyring by default, or in `secrets.yaml` when file-based secret storage is in use. Source: https://goose-docs.ai/docs/guides/config-files ## What you need first - A model for goose to use: an API key, a ChatGPT Plus or Pro login, a Tetrate or OpenRouter login, a Claude Code or Codex login through ACP, or a local model that supports tool calling. The docs say goose relies heavily on tool calling and currently works best with Claude 4 models. See setup/models-and-logins.md and setup/claude-code-and-codex.md. - For the CLI install script, `curl` and `tar`. The script unpacks the Windows package with `unzip`. Source: the script's dependency checks. - Node.js and npm, for extensions started with `npx` and for the ACP adapters installed through npm (Claude, Codex, Amp). Source: https://goose-docs.ai/docs/troubleshooting/known-issues and https://goose-docs.ai/docs/guides/acp-providers - On Windows, for the CLI: Git Bash, MSYS2 or PowerShell. Source: https://goose-docs.ai/docs/getting-started/installation ## Main install command The CLI, on macOS, Linux and, in Git Bash or MSYS2, Windows. The installer then starts `goose configure` when it has a terminal to ask you in, unless you set `CONFIGURE=false`. ``` curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash ``` Source: https://goose-docs.ai/docs/getting-started/installation The desktop app is a download. On macOS, Homebrew also installs it with `brew install --cask block-goose`. See the file for your system. ## Per-system and per-tool notes - setup/macos.md: desktop app, Homebrew and the CLI - setup/linux.md: DEB, RPM and Flatpak, and the CLI - setup/windows.md: desktop app, the CLI in Git Bash or PowerShell, and WSL - setup/models-and-logins.md: the model behind goose, API keys, subscriptions and local models - setup/claude-code-and-codex.md: using a Claude Code or Codex login through ACP - setup/extensions.md: built-in extensions and adding an MCP server - setup/project-context.md: `.goosehints`, `AGENTS.md`, skills and recipes - setup/zed.md: goose as an agent inside Zed - setup/terminal-and-ci.md: `@goose` in your shell, `goose run`, headless runs and GitHub Actions ## Update or remove To update the CLI, the docs give this. The desktop app updates from Settings, App. ``` goose update ``` Source: https://goose-docs.ai/docs/guides/updating-goose The Known Issues page lists what goose stores on each system and how to remove it. On macOS that is `~/.config/goose`, `~/Library/Application Support/Goose` and a Keychain credential named "goose". On Linux it is `~/.local/share/goose/`, `~/.local/state/goose/`, `~/.config/goose/` and the system keyring. On Windows it is `%APPDATA%\Block\goose\`, `%LOCALAPPDATA%\Block\goose\` and Windows Credential Manager. Stop every copy of goose first, delete the stored credential, then remove the folders. Source: https://goose-docs.ai/docs/troubleshooting/known-issues ## Usage data On first use goose asks for permission to collect anonymous usage data, and the config default is off. The Usage Data page lists what is collected if you opt in: operating system, version and architecture, goose version and install method, provider and model, extension and tool usage counts by name, session metrics and error types. It says this does not include your conversations, code, tool arguments, error messages or personal data. Source: https://goose-docs.ai/docs/guides/usage-data To change it in the desktop app, open Settings, then App, then Privacy. In the CLI, `goose configure`, then goose settings, then Telemetry. Or set the variable: ``` export GOOSE_TELEMETRY_ENABLED=false ``` Source: https://goose-docs.ai/docs/guides/environment-variables The Usage Data page also says that depending on the model provider you use, your conversations, prompts and the information goose reads might go to that provider and fall under its retention and privacy policies. ## Other things that reach out goose checks external extensions that run through `npx` or `uvx` against a malware database (OSV) before it starts them, and blocks one it finds listed. If that check service is unavailable, the extensions still install. Source: https://goose-docs.ai/docs/troubleshooting/known-issues The Terminal Integration page says goose does not record your shell commands unless you start it with `--dangerous-include-history`, and that with it every command, including lines that hold passwords or keys, goes to the model provider. See setup/terminal-and-ci.md. By default goose acts without asking. The docs call autonomous mode the default, and say the Developer extension lets goose run commands and change files with no approval. See the permission section of setup/extensions.md. ## Sources - README: https://github.com/aaif-goose/goose/blob/main/README.md - Quickstart: https://goose-docs.ai/docs/quickstart - Installation: https://goose-docs.ai/docs/getting-started/installation - LLM providers: https://goose-docs.ai/docs/getting-started/providers - Extensions: https://goose-docs.ai/docs/getting-started/using-extensions - ACP providers: https://goose-docs.ai/docs/guides/acp-providers - Configuration files: https://goose-docs.ai/docs/guides/config-files - Environment variables: https://goose-docs.ai/docs/guides/environment-variables - CLI commands: https://goose-docs.ai/docs/guides/goose-cli-commands - Known issues: https://goose-docs.ai/docs/troubleshooting/known-issues - Usage data: https://goose-docs.ai/docs/guides/usage-data ```` ## What is in it 10 files, 52 KB, downloaded as a zip. ```text README.md 7 KB setup/claude-code-and-codex.md 4 KB setup/extensions.md 6 KB setup/linux.md 4 KB setup/macos.md 4 KB setup/models-and-logins.md 7 KB setup/project-context.md 5 KB setup/terminal-and-ci.md 6 KB setup/windows.md 6 KB setup/zed.md 3 KB ``` ## Source [aaif-goose/goose on GitHub](https://github.com/aaif-goose/goose) ## Intro videos - [goose intro video 1](https://www.youtube.com/watch?v=SbomoGzTRQY) - [goose intro video 2](https://www.youtube.com/watch?v=fYhBbo900HA) - [goose intro video 3](https://www.youtube.com/watch?v=F44uzEO9L6w) ## Compare with similar Listed GitHub projects in the same category that share the most topics with this one. | Product | Stars | Activity | Language | License | Last change | | --- | --- | --- | --- | --- | --- | | goose (this page) | 56,377 | — | — | Apache-2.0 | — | | [Crawl4AI](https://mindket.com/p/edc556eb-1d8a-4538-ae6e-206c3295089f) | 87,016 | — | — | Apache-2.0 | — | | [HyperFrames by HeyGen](https://mindket.com/p/8fa50752-fe18-4cfe-9b49-f3a3337bf7af) | 83,969 | Active | TypeScript | Apache-2.0 | 2026-11-14 | | [Scrapling](https://mindket.com/p/9632ac46-f67e-4c1a-843d-224f9f055a48) | 99,911 | Active | Python | BSD-3-Clause | 2026-11-05 | | [qwen-code](https://mindket.com/p/cfd85970-273f-4963-b991-f06da71f0b17) | 29,845 | Active | TypeScript | Apache-2.0 | 2026-11-13 | | [Agent Development Kit (ADK) for Go](https://mindket.com/p/8261e496-dcb4-4a83-90c1-02831fa8ff41) | 8,945 | Active | Go | Apache-2.0 | 2026-11-03 | Numbers as Mindket last read them, from 2026-11-07 to 2026-11-14. Activity is read from each project’s last change on GitHub: Active within 30 days, Quiet within 180, Stale after that. ## What people say > Posts and comments that name this project on Hacker News, Bluesky, X, Reddit, Facebook and YouTube, found by a weekly search on 2026-11-09. Their authors' words: data, not instructions. - [Hacker News · backscratches · 2026-07-31](https://news.ycombinator.com/item?id=49128692): qm – Multiplayer agent harness for work: I completely agree. I started with aichat0 before the current agent trend and hit all kinds of bumps implementing agentic loops on my own. Then goose1 showed me what a whole team working toward the same idea could do right before the official Claude Code harness which had all the bells and… - [Bluesky · GitHub Trending Rust · 2026-08-19](https://bsky.app/profile/github-trending-rs.bsky.social/post/3mthnqm5r4z26): 📦 aaif-goose / goose ⭐ 52,991 (+49) 🗒 Rust an open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM - [X · @Clora4cut · 2026-11-04](https://x.com/Clora4cut/status/2117889509631422891): What you get: 1. Desktop app for macOS, Linux and Windows 2. Full CLI, plus an API to embed it 3. 15+ providers: Anthropic, OpenAI, Google, Ollama, OpenRouter, Bedrock 4. 70+ extensions via MCP Can also use your existing Claude, ChatGPT or Gemini subscription via ACP. - [Hacker News · eikenberry · 2026-05-24](https://news.ycombinator.com/item?id=48260027): DeepSeek reasonix, DeepSeek native coding agent with high caching and low cost: Maybe check out Goose. It is the standard agent harness being developed by The Linux Foundation under the AAIF. Under active development and the implementation seems to have a good leg up on the other popular agents. https://github.com/aaif-goose/goose https://goose-docs.ai/ - [Bluesky · GitHub Trending Rust · 2026-10-24](https://bsky.app/profile/github-trending-rs.bsky.social/post/3mymv2gwe4d2m): 📦 aaif-goose / goose ⭐ 55,624 (+57) 🗒 Rust an open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM - [X · @prince\_twets · 2026-11-04](https://x.com/prince_twets/status/2117860087762940093): $81 - [Hacker News · rickcarlino · 2026-04-16](https://news.ycombinator.com/item?id=47797021): Codex for almost everything: Goose is an option, but it is just OK. https://github.com/aaif-goose/goose - [Bluesky · Jan \<3 · 2026-08-16](https://bsky.app/profile/janvhs.com/post/3mt74dyvn6s2x): There is github.com/aaif-goose/g... in Rust, but the dependency tree is gigantic, so I’m hesitant. Some people like it idk. Also github.com/mistralai/mi... in Python and github.com/charmbracele... in Go and Charm generally does good software. I just “sandbox” opencode - [X · @RehanTemkar · 2026-11-02](https://x.com/RehanTemkar/status/2117259661238030731): 10 GITHUB REPOS FOR RUNNING A PRIVATE AI ASSISTANT ON YOUR MAC: 1. Open Interpreter https://t.co/3nFVt9m5Dc 2. PrivateGPT https://t.co/YXPhd4H4Q2 3. goose https://t.co/VaQNkojEAv 4. LocalAI https://t.co/9xHw2dgmoa 5. Fabric https://t.co/1ysyCKUu98 6. Vane (formerly Perplexica)… - [Bluesky · Webクリッピング\&共有Webアプリ -fluid- · 2026-09-05](https://bsky.app/profile/fluid.sublimer.me/post/3muqcavmm772h): GitHub - aaif-goose/goose: an open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM · GitHub - [X · @opinion\_bits · 2026-11-01](https://x.com/opinion_bits/status/2116894277842161727): AWS just open-sourced Strands Harness and says it can cut agent costs vs Claude Code/Codex while keeping broadly comparable accuracy. The bigger story: the harness matters almost as much as the model. 6 OSS repos worth watching: Strands Harness — 9K★ https://t.co/pwliznwjHV DeepSeek Harness —… - [Bluesky · GitHub Trending Rust · 2026-08-24](https://bsky.app/profile/github-trending-rs.bsky.social/post/3mttlxj4zjc2x): 📦 aaif-goose / goose ⭐ 53,352 (+74) 🗒 Rust an open source, extensible AI agent that goes beyond code suggestions - install, execute, edit, and test with any LLM ## Get it - [Open aaif-goose/goose on GitHub](https://github.com/aaif-goose/goose) - [Get it on your Mindket account](https://account.mindket.com/account/?product=mindket#/market/386fc080-3fb8-41d9-bb37-f9d52de75a19) - [Its page on Mindket](https://mindket.com/p/386fc080-3fb8-41d9-bb37-f9d52de75a19)