chore(aaif): rename a bunch of repository references (#8152)

Signed-off-by: Michael Neale <michael.neale@gmail.com>
Co-authored-by: Michael Neale <michael.neale@gmail.com>

continuing migration to aaif
This commit is contained in:
Jack Amadeo
2026-04-07 01:34:48 -04:00
committed by GitHub
parent 0b080faad5
commit 583acd4335
236 changed files with 1097 additions and 962 deletions
+1 -1
View File
@@ -6,7 +6,7 @@ body:
attributes:
value: |
💡 Before posting, please attach your **diagnostics zip** — it helps the Goose team debug faster and saves everyone time.
[How to capture and share diagnostics](https://block.github.io/goose/docs/troubleshooting/diagnostics-and-reporting/)
[How to capture and share diagnostics](https://goose-docs.ai/docs/troubleshooting/diagnostics-and-reporting/)
- type: textarea
id: problem
attributes:
+2 -2
View File
@@ -9,10 +9,10 @@ assignees: ''
**Describe the bug**
💡 Before filing, please check common issues:
https://block.github.io/goose/docs/troubleshooting
https://goose-docs.ai/docs/troubleshooting
📦 To help us debug faster, attach your **diagnostics zip** if possible.
👉 How to capture it: https://block.github.io/goose/docs/troubleshooting/diagnostics-and-reporting/
👉 How to capture it: https://goose-docs.ai/docs/troubleshooting/diagnostics-and-reporting/
A clear and concise description of what the bug is.
+1 -1
View File
@@ -4,5 +4,5 @@ contact_links:
url: https://discord.gg/goose-oss
about: Please ask and answer questions here.
- name: Report a security vulnerability
url: https://github.com/block/goose/security/policy
url: https://github.com/aaif-goose/goose/security/policy
about: Please report security vulnerabilities here.
+1 -1
View File
@@ -15,7 +15,7 @@ body:
- Paste it into the field and submit the issue — we'll review and add it to the cookbook!
🪄 **What Happens After?**
- If accepted, we'll publish your recipe to the [goose recipes cookbook](https://block.github.io/goose/recipes)
- If accepted, we'll publish your recipe to the [goose recipes cookbook](https://goose-docs.ai/recipes)
- Your GitHub handle will be displayed and linked on the recipe card
- If the YAML has any issues, goose will comment with validation errors so you can fix and resubmit.
+1 -1
View File
@@ -18,7 +18,7 @@ on:
jobs:
deny:
runs-on: ubuntu-latest
if: github.repository == 'block/goose'
if: github.repository == 'aaif-goose/goose'
permissions:
contents: read
steps:
+1 -1
View File
@@ -16,7 +16,7 @@ on:
jobs:
machete:
runs-on: ubuntu-latest
if: github.repository == 'block/goose'
if: github.repository == 'aaif-goose/goose'
permissions:
contents: read
steps:
+1 -1
View File
@@ -77,7 +77,7 @@ jobs:
timeout-minutes: 15
container:
image: ghcr.io/block/goose:latest
image: ghcr.io/aaif-goose/goose:latest
options: --user root
env:
HOME: /tmp/goose-home
+3 -3
View File
@@ -49,10 +49,10 @@ jobs:
fetch-tags: true # Fetch all tags so we can checkout version tags
- name: Fetch upstream tags (for forks)
if: github.repository != 'block/goose'
if: github.repository != 'aaif-goose/goose'
run: |
# Add upstream remote and fetch tags (only needed when testing in forks)
git remote add upstream https://github.com/block/goose.git || git remote set-url upstream https://github.com/block/goose.git
git remote add upstream https://github.com/aaif-goose/goose.git || git remote set-url upstream https://github.com/aaif-goose/goose.git
git fetch upstream --tags --force
echo "✅ Fetched tags from upstream (fork mode)"
echo "Total tags available: $(git tag | wc -l)"
@@ -80,7 +80,7 @@ jobs:
- name: Install goose CLI
run: |
mkdir -p /home/runner/.local/bin
curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh \
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh \
| CONFIGURE=false GOOSE_BIN_DIR=/home/runner/.local/bin bash
echo "/home/runner/.local/bin" >> $GITHUB_PATH
goose --version
+3 -3
View File
@@ -47,10 +47,10 @@ jobs:
fetch-tags: true # Fetch all tags so we can checkout version tags
- name: Fetch upstream tags (for forks)
if: github.repository != 'block/goose'
if: github.repository != 'aaif-goose/goose'
run: |
# Add upstream remote and fetch tags (only needed when testing in forks)
git remote add upstream https://github.com/block/goose.git || git remote set-url upstream https://github.com/block/goose.git
git remote add upstream https://github.com/aaif-goose/goose.git || git remote set-url upstream https://github.com/aaif-goose/goose.git
git fetch upstream --tags --force
echo "✅ Fetched tags from upstream (fork mode)"
echo "Total tags available: $(git tag | wc -l)"
@@ -68,7 +68,7 @@ jobs:
- name: Install goose CLI
run: |
mkdir -p /home/runner/.local/bin
curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh \
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh \
| CONFIGURE=false GOOSE_BIN_DIR=/home/runner/.local/bin bash
echo "/home/runner/.local/bin" >> $GITHUB_PATH
goose --version
+1 -1
View File
@@ -131,7 +131,7 @@ jobs:
timeout-minutes: 30
container:
image: ghcr.io/block/goose:latest
image: ghcr.io/aaif-goose/goose:latest
options: --user root
env:
GOOSE_PROVIDER: ${{ vars.GOOSE_PROVIDER || 'anthropic' }}
+1 -1
View File
@@ -223,7 +223,7 @@ jobs:
timeout-minutes: 15
container:
image: ghcr.io/block/goose:latest
image: ghcr.io/aaif-goose/goose:latest
options: --user root
env:
GOOSE_PROVIDER: ${{ vars.GOOSE_PROVIDER || 'anthropic' }}
+3 -3
View File
@@ -51,7 +51,7 @@ env:
- 📚 **Documentation** - Documentation updates
Format each item as:
- Concise description [#XXXX](https://github.com/block/goose/pull/XXXX)
- Concise description [#XXXX](https://github.com/aaif-goose/goose/pull/XXXX)
Rules:
- Extract PR numbers from commit messages (look for (#XXXX) pattern)
@@ -85,7 +85,7 @@ jobs:
github.event.workflow_run.head_branch != 'stable')
container:
image: ghcr.io/block/goose:latest
image: ghcr.io/aaif-goose/goose:latest
options: --user root
env:
GOOSE_PROVIDER: ${{ vars.GOOSE_PROVIDER || 'anthropic' }}
@@ -190,7 +190,7 @@ jobs:
DISCORD_BOT_TOKEN: ${{ secrets.DISCORD_RELEASE_BOT_TOKEN }}
DISCORD_CHANNEL_ID: ${{ secrets.DISCORD_RELEASE_BOT_CHANNEL_ID }}
RELEASE_TAG: ${{ needs.generate-release-notes.outputs.release_tag }}
RELEASE_URL: https://github.com/block/goose/releases/tag/${{ needs.generate-release-notes.outputs.release_tag }}
RELEASE_URL: https://github.com/aaif-goose/goose/releases/tag/${{ needs.generate-release-notes.outputs.release_tag }}
RELEASE_NOTES: ${{ needs.generate-release-notes.outputs.release_notes }}
NOTES_LENGTH: ${{ needs.generate-release-notes.outputs.notes_length }}
shell: bash
+1 -1
View File
@@ -11,7 +11,7 @@ on:
jobs:
release:
if: github.repository == 'block/goose'
if: github.repository == 'aaif-goose/goose'
uses: ./.github/workflows/create-version-bump-pr.yaml
secrets:
ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}
+4 -1
View File
@@ -17,6 +17,9 @@ concurrency:
jobs:
deploy:
runs-on: ubuntu-latest
permissions:
contents: write
pull-requests: write
steps:
- name: Checkout the branch
uses: actions/checkout@8e8c483db84b4bee98b60c0593521ed34d9990e8 # v6.0.1
@@ -41,7 +44,7 @@ jobs:
- name: Deploy preview
uses: rossjrw/pr-preview-action@ffa7509e91a3ec8dfc2e5536c4d5c1acdf7a6de9 # v1.8.1
if: ${{ github.event.pull_request.head.repo.full_name == 'block/goose' }}
if: ${{ github.event.pull_request.head.repo.full_name == 'aaif-goose/goose' }}
with:
source-dir: documentation/build
@@ -23,7 +23,7 @@ concurrency:
jobs:
rebuild-docs:
runs-on: ubuntu-latest
if: github.repository == 'block/goose'
if: github.repository == 'aaif-goose/goose'
permissions:
contents: write
+1 -1
View File
@@ -22,7 +22,7 @@ jobs:
name: Scorecard analysis
runs-on: ubuntu-latest
# `publish_results: true` only works when run from the default branch. conditional can be removed if disabled.
if: github.repository == 'block/goose' && (github.event.repository.default_branch == github.ref_name || github.event_name == 'pull_request')
if: github.repository == 'aaif-goose/goose' && (github.event.repository.default_branch == github.ref_name || github.event_name == 'pull_request')
permissions:
# Needed to upload the results to code-scanning dashboard.
security-events: write
+1 -1
View File
@@ -24,7 +24,7 @@ jobs:
stale:
name: 'Mark and Close Stale PRs'
runs-on: ubuntu-latest
if: github.repository == 'block/goose'
if: github.repository == 'aaif-goose/goose'
steps:
# Use the official stale action from GitHub
+1 -1
View File
@@ -20,7 +20,7 @@ jobs:
find-untested-code:
runs-on: ubuntu-latest
container:
image: ghcr.io/block/goose:latest
image: ghcr.io/aaif-goose/goose:latest
options: --user root
env:
GOOSE_PROVIDER: ${{ vars.GOOSE_PROVIDER || 'openai' }}
@@ -9,7 +9,7 @@ on:
jobs:
update-leaderboard:
runs-on: ubuntu-latest
if: github.repository == 'block/goose'
if: github.repository == 'aaif-goose/goose'
permissions:
contents: read
pull-requests: read
@@ -29,7 +29,7 @@ jobs:
// Track the Goose repo only
const REPOS = [
'block/goose'
'aaif-goose/goose'
];
const POINT_VALUES = { small: 5, medium: 10, large: 15 };
@@ -23,7 +23,7 @@ jobs:
update-dashboard:
name: 'Update Health Dashboard'
runs-on: ubuntu-latest
if: github.repository == 'block/goose'
if: github.repository == 'aaif-goose/goose'
steps:
- name: 'Download previous metrics'
+11 -11
View File
@@ -10,17 +10,17 @@ The easiest way to use goose with Docker is to pull the pre-built image from Git
```bash
# Pull the latest image
docker pull ghcr.io/block/goose:latest
docker pull ghcr.io/aaif-goose/goose:latest
# Run goose CLI
docker run --rm ghcr.io/block/goose:latest --version
docker run --rm ghcr.io/aaif-goose/goose:latest --version
# Run with LLM configuration
docker run --rm \
-e GOOSE_PROVIDER=openai \
-e GOOSE_MODEL=gpt-4o \
-e OPENAI_API_KEY=$OPENAI_API_KEY \
ghcr.io/block/goose:latest run -t "Hello, world!"
ghcr.io/aaif-goose/goose:latest run -t "Hello, world!"
```
## Building from Source
@@ -35,7 +35,7 @@ docker run --rm \
1. Clone the repository:
```bash
git clone https://github.com/block/goose.git
git clone https://github.com/aaif-goose/goose.git
cd goose
```
@@ -110,7 +110,7 @@ version: '3.8'
services:
goose:
image: ghcr.io/block/goose:latest
image: ghcr.io/aaif-goose/goose:latest
environment:
- GOOSE_PROVIDER=${GOOSE_PROVIDER:-openai}
- GOOSE_MODEL=${GOOSE_MODEL:-gpt-4o}
@@ -163,7 +163,7 @@ docker run --rm \
-c "apt-get update && apt-get install -y vim && goose --version"
# Or create a custom Dockerfile
FROM ghcr.io/block/goose:latest
FROM ghcr.io/aaif-goose/goose:latest
USER root
RUN apt-get update && apt-get install -y \
vim \
@@ -181,7 +181,7 @@ jobs:
analyze:
runs-on: ubuntu-latest
container:
image: ghcr.io/block/goose:latest
image: ghcr.io/aaif-goose/goose:latest
env:
GOOSE_PROVIDER: openai
GOOSE_MODEL: gpt-4o
@@ -197,7 +197,7 @@ jobs:
```yaml
analyze:
image: ghcr.io/block/goose:latest
image: ghcr.io/aaif-goose/goose:latest
variables:
GOOSE_PROVIDER: openai
GOOSE_MODEL: gpt-4o
@@ -298,7 +298,7 @@ For production deployments:
Example production Dockerfile:
```dockerfile
FROM ghcr.io/block/goose:v1.6.0
FROM ghcr.io/aaif-goose/goose:v1.6.0
# Add any additional tools needed for your use case
USER root
RUN apt-get update && apt-get install -y your-tools && rm -rf /var/lib/apt/lists/*
@@ -318,5 +318,5 @@ When contributing Docker-related changes:
## Related Documentation
- [goose in Docker Tutorial](documentation/docs/tutorials/goose-in-docker.md) - Step-by-step tutorial
- [Installation Guide](https://block.github.io/goose/docs/getting-started/installation) - All installation methods
- [Configuration Guide](https://block.github.io/goose/docs/guides/config-files) - Detailed configuration options
- [Installation Guide](https://goose-docs.ai/docs/getting-started/installation) - All installation methods
- [Configuration Guide](https://goose-docs.ai/docs/guides/config-files) - Detailed configuration options
+3 -3
View File
@@ -30,9 +30,9 @@ sudo zypper install dpkg fakeroot gcc gcc-c++ make
**android / termux:**
goose is not officially support termux build yet, you need some minor patch to fix build issues.
We will publish goose (block-goose) into termux-packages.
We will publish goose (block-goose) into termux-packages. <!-- NOTE: package name kept for backwards compat -->
If you want to try there is a non-official build, https://github.com/shawn111/goose/releases/download/termux/goose-termux-aarch64.tar.bz2
For more details, see: https://github.com/block/goose/pull/3890
For more details, see: https://github.com/aaif-goose/goose/pull/3890
```bash
pkg install rust
@@ -49,7 +49,7 @@ pkg install cmake protobuf clang build-essential
### 1. Clone and Setup
```bash
git clone https://github.com/block/goose.git
git clone https://github.com/aaif-goose/goose.git
cd goose
```
+6 -6
View File
@@ -213,7 +213,7 @@ and stepping through the server code while interacting with the UI.
To fork the repository:
1. Go to https://github.com/block/goose and click “Fork” (top-right corner).
1. Go to https://github.com/aaif-goose/goose and click “Fork” (top-right corner).
2. This creates https://github.com/<your-username>/goose under your GitHub account.
3. Clone your fork (not the main repo):
@@ -225,7 +225,7 @@ cd goose
4. Add the main repository as upstream:
```
git remote add upstream https://github.com/block/goose.git
git remote add upstream https://github.com/aaif-goose/goose.git
```
5. Create a branch in your fork for your changes:
@@ -250,7 +250,7 @@ git merge upstream/main
git push origin my-feature-branch
```
8. Open a Pull Request from your branch on your fork to block/gooses main branch.
8. Open a Pull Request from your branch on your fork to aaif-goose/gooses main branch.
## Keeping Your Fork Up-to-Date
@@ -262,7 +262,7 @@ repository. This helps avoid conflicts and allows us to merge your pull requests
1. **Add the Main Repository as a Remote** (Skip if you have already set this up):
```bash
git remote add upstream https://github.com/block/goose.git
git remote add upstream https://github.com/aaif-goose/goose.git
```
2. **Fetch the Latest Changes from the Main Repository**:
@@ -346,7 +346,7 @@ Then you can view your traces at http://localhost:3000
This project follows the [Conventional Commits](https://www.conventionalcommits.org/en/v1.0.0/) specification for PR titles. Conventional Commits make it easier to understand the history of a project and facilitate automation around versioning and changelog generation.
[issues]: https://github.com/block/goose/issues
[issues]: https://github.com/aaif-goose/goose/issues
[hermit]: https://cashapp.github.io/hermit/
[just]: https://github.com/casey/just?tab=readme-ov-file#installation
@@ -366,7 +366,7 @@ There are numerous ways to be an open source contributor and contribute to goose
- **Stars on GitHub:** If you resonate with our project and find it valuable, consider starring our goose on GitHub! 🌟
- **Ask Questions:** Your questions not only help us improve but also benefit the community. If you have a question, don't hesitate to ask it on [Discord](https://discord.gg/goose-oss).
- **Give Feedback:** Have a feature you want to see or encounter an issue with goose, [click here to open an issue](https://github.com/block/goose/issues/new/choose), [start a discussion](https://github.com/block/goose/discussions) or tell us on Discord.
- **Give Feedback:** Have a feature you want to see or encounter an issue with goose, [click here to open an issue](https://github.com/aaif-goose/goose/issues/new/choose), [start a discussion](https://github.com/aaif-goose/goose/discussions) or tell us on Discord.
- **Participate in Community Events:** We host a variety of community events and livestreams on Discord every month, ranging from workshops to brainstorming sessions. You can subscribe to our [events calendar](https://calget.com/c/t7jszrie) or follow us on [social media](https://linktr.ee/goose_oss) to stay in touch.
- **Improve Documentation:** Good documentation is key to the success of any project. You can help improve the quality of our existing docs or add new pages.
- **Help Other Members:** See another community member stuck? Or a contributor blocked by a question you know the answer to? Reply to community threads or do a code review for others to help.
+5 -5
View File
@@ -4,7 +4,7 @@ Thank you for your interest in contributing to the goose Recipe Cookbook! This g
## 🚀 Quick Start
1. [Fork this repository](https://github.com/block/goose/fork)
1. [Fork this repository](https://github.com/aaif-goose/goose/fork)
2. Add your recipe file here: `documentation/src/pages/recipes/data/recipes/`
3. Create a pull request
@@ -62,7 +62,7 @@ parameters:
default: "default_value"
```
📚 **Need help with the format?** Check out the [Recipe Reference Guide](https://block.github.io/goose/docs/guides/recipes/recipe-reference) or [existing recipes](documentation/src/pages/recipes/data/recipes/) for examples.
📚 **Need help with the format?** Check out the [Recipe Reference Guide](https://goose-docs.ai/docs/guides/recipes/recipe-reference) or [existing recipes](documentation/src/pages/recipes/data/recipes/) for examples.
### Step 4: Create a Pull Request
@@ -84,7 +84,7 @@ Your recipe should:
- [ ] **Work correctly** - Test it before submitting
- [ ] **Be useful** - Solve a real problem or demonstrate a valuable workflow
- [ ] **Follow the format** - Refer to the [Recipe Reference Guide](https://block.github.io/goose/docs/guides/recipes/recipe-reference)
- [ ] **Follow the format** - Refer to the [Recipe Reference Guide](https://goose-docs.ai/docs/guides/recipes/recipe-reference)
- [ ] **Have a unique filename** - No conflicts with existing recipe files
### 📝 **Naming Guidelines:**
@@ -119,7 +119,7 @@ Need inspiration? Consider recipes for:
- 📖 **Browse existing recipes** for examples
- 💬 **Ask questions** in your PR
- 🐛 **Report issues** if something isn't working
- 📚 **Check the docs** at [block.github.io/goose](https://block.github.io/goose/docs/guides/recipes/)
- 📚 **Check the docs** at [goose-docs.ai](https://goose-docs.ai/docs/guides/recipes/)
## 🤝 Community Guidelines
@@ -128,6 +128,6 @@ Need inspiration? Consider recipes for:
---
**Ready to contribute?** [Fork the repo](https://github.com/block/goose/fork) and start creating!
**Ready to contribute?** [Fork the repo](https://github.com/aaif-goose/goose/fork) and start creating!
*Questions? Ask in your PR or hop into [discord](https://discord.gg/goose-oss) - we're here to help!* 💙
+4 -4
View File
@@ -1,6 +1,6 @@
[workspace]
members = [
"crates/*",
"crates/*",
# Mainly for cargo-machete to not error out during inspection.
"vendor/v8"
]
@@ -9,9 +9,9 @@ resolver = "2"
[workspace.package]
edition = "2021"
version = "1.30.0"
authors = ["Block <ai-oss-tools@block.xyz>"]
authors = ["AAIF <ai-oss-tools@block.xyz>"]
license = "Apache-2.0"
repository = "https://github.com/block/goose"
repository = "https://github.com/aaif-goose/goose"
description = "An AI agent"
[workspace.lints.clippy]
@@ -105,4 +105,4 @@ opentelemetry = { git = "https://github.com/open-telemetry/opentelemetry-rust",
opentelemetry_sdk = { git = "https://github.com/open-telemetry/opentelemetry-rust", rev = "345cd74a" }
opentelemetry-appender-tracing = { git = "https://github.com/open-telemetry/opentelemetry-rust", rev = "345cd74a" }
opentelemetry-otlp = { git = "https://github.com/open-telemetry/opentelemetry-rust", rev = "345cd74a" }
opentelemetry-stdout = { git = "https://github.com/open-telemetry/opentelemetry-rust", rev = "345cd74a" }
opentelemetry-stdout = { git = "https://github.com/open-telemetry/opentelemetry-rust", rev = "345cd74a" }
+2 -2
View File
@@ -72,5 +72,5 @@ CMD ["--help"]
# Labels for metadata
LABEL org.opencontainers.image.title="goose"
LABEL org.opencontainers.image.description="goose CLI"
LABEL org.opencontainers.image.vendor="Block"
LABEL org.opencontainers.image.source="https://github.com/block/goose"
LABEL org.opencontainers.image.vendor="AAIF"
LABEL org.opencontainers.image.source="https://github.com/aaif-goose/goose"
+2 -2
View File
@@ -175,7 +175,7 @@ This governance model may evolve as goose grows. Any proposed modification to th
## Current Membership
Core Maintainers and Maintainers are listed in the main goose repository's [MAINTAINERS.md](https://github.com/block/goose/blob/main/MAINTAINERS.md) file with their areas of expertise where applicable.
Core Maintainers and Maintainers are listed in the main goose repository's [MAINTAINERS.md](https://github.com/aaif-goose/goose/blob/main/MAINTAINERS.md) file with their areas of expertise where applicable.
## Summary
@@ -190,7 +190,7 @@ We believe this balance enables goose to remain innovative while building a stro
# General Project Policies
Founded by Block, goose has been established as a Series of LF Projects, LLC. Policies applicable to goose and participants in the goose project, including guidelines on the usage of trademarks, are located at [https://lfprojects.org/policies/](https://lfprojects.org/policies/). Governance changes approved as per the provisions of this governance document must also be approved by LF Projects, LLC.
Founded by Block and now stewarded by AAIF (Agentic AI Foundation), goose has been established as a Series of LF Projects, LLC. Policies applicable to goose and participants in the goose project, including guidelines on the usage of trademarks, are located at [https://lfprojects.org/policies/](https://lfprojects.org/policies/). Governance changes approved as per the provisions of this governance document must also be approved by LF Projects, LLC.
goose participants acknowledge that the copyright in all new contributions will be retained by the copyright holder as independent works of authorship and that no contributor or copyright holder will be required to assign copyrights to the project.
Except as described below, all code and specification contributions to the project must be made using the Apache License, Version 2.0 available at (the “Project License”).
+12 -12
View File
@@ -9,8 +9,8 @@ _a local, extensible, open source AI agent that automates engineering tasks_
><img src="https://img.shields.io/badge/License-Apache_2.0-blue.svg"></a>
<a href="https://discord.gg/goose-oss"
><img src="https://img.shields.io/discord/1287729918100246654?logo=discord&logoColor=white&label=Join+Us&color=blueviolet" alt="Discord"></a>
<a href="https://github.com/block/goose/actions/workflows/ci.yml"
><img src="https://img.shields.io/github/actions/workflow/status/block/goose/ci.yml?branch=main" alt="CI"></a>
<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>
</p>
</div>
@@ -23,16 +23,16 @@ Designed for maximum flexibility, goose works with any LLM and supports multi-mo
[![Watch the video](https://github.com/user-attachments/assets/ddc71240-3928-41b5-8210-626dfb28af7a)](https://youtu.be/D-DpDunrbpo)
# Quick Links
- [Quickstart](https://block.github.io/goose/docs/quickstart)
- [Installation](https://block.github.io/goose/docs/getting-started/installation)
- [Tutorials](https://block.github.io/goose/docs/category/tutorials)
- [Documentation](https://block.github.io/goose/docs/category/getting-started)
- [Governance](https://github.com/block/goose/blob/main/GOVERNANCE.md)
- [Custom Distributions](https://github.com/block/goose/blob/main/CUSTOM_DISTROS.md) - build your own goose distro with preconfigured providers, extensions, and branding
- [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)
- [Custom Distributions](https://github.com/aaif-goose/goose/blob/main/CUSTOM_DISTROS.md) - build your own goose distro with preconfigured providers, extensions, and branding
## Need Help?
- [Diagnostics & Reporting](https://block.github.io/goose/docs/troubleshooting/diagnostics-and-reporting)
- [Known Issues](https://block.github.io/goose/docs/troubleshooting/known-issues)
- [Diagnostics & Reporting](https://goose-docs.ai/docs/troubleshooting/diagnostics-and-reporting)
- [Known Issues](https://goose-docs.ai/docs/troubleshooting/known-issues)
# a little goose humor 🪿
@@ -45,5 +45,5 @@ Designed for maximum flexibility, goose works with any LLM and supports multi-mo
- [YouTube](https://www.youtube.com/@goose-oss)
- [LinkedIn](https://www.linkedin.com/company/goose-oss)
- [Twitter/X](https://x.com/goose_oss)
- [Bluesky](https://bsky.app/profile/opensource.block.xyz)
- [Nostr](https://njump.me/opensource@block.xyz)
- [Bluesky](https://bsky.app/profile/opensource.block.xyz) <!-- TODO: update social handle after transfer -->
- [Nostr](https://njump.me/opensource@block.xyz) <!-- TODO: update social handle after transfer -->
+3 -3
View File
@@ -8,7 +8,7 @@ goose uses GitHub actions to automate the release process. The actual releases a
These are typically done once per week. The process has two automated phases:
1. **Version bump PR** — An [action](https://github.com/block/goose/actions/workflows/minor-release.yaml) runs every Tuesday (or can be triggered manually) that creates a PR to bump the version on `main`. Review and merge this PR.
1. **Version bump PR** — An [action](https://github.com/aaif-goose/goose/actions/workflows/minor-release.yaml) runs every Tuesday (or can be triggered manually) that creates a PR to bump the version on `main`. Review and merge this PR.
2. **Release branch + PR** — When the version bump PR merges, automation creates a `release/<version>` branch from `main` and opens a release PR with a QA checklist.
@@ -18,13 +18,13 @@ From there:
- Download and test the .zip from the release PR
- When ready, follow the instructions on the release PR to tag and release
To trigger the release, find [the corresponding PR](https://github.com/block/goose/pulls?q=is%3Apr+%22chore%28release%29%22+author%3Aapp%2Fgithub-actions+) and follow the instructions in the PR description.
To trigger the release, find [the corresponding PR](https://github.com/aaif-goose/goose/pulls?q=is%3Apr+%22chore%28release%29%22+author%3Aapp%2Fgithub-actions+) and follow the instructions in the PR description.
## Patch version releases
When a minor release is tagged, automation immediately creates the next patch release branch (e.g. `release/1.25.1` from `release/1.25.0`) with the version already bumped and a release PR open. Cherry-pick fixes into this branch, then tag when ready.
To trigger the release, find [the corresponding PR](https://github.com/block/goose/pulls?q=is%3Apr+%22chore%28release%29%22+%22%28patch%29%22+author%3Aapp%2Fgithub-actions+) and follow the instructions in the PR description.
To trigger the release, find [the corresponding PR](https://github.com/aaif-goose/goose/pulls?q=is%3Apr+%22chore%28release%29%22+%22%28patch%29%22+author%3Aapp%2Fgithub-actions+) and follow the instructions in the PR description.
## High level release flow:
+2 -2
View File
@@ -10,6 +10,6 @@
>
> In some circumstances, goose may follow commands found embedded in content even if those commands conflict with the task given to goose. We suggest taking the precautions above to limit risks from prompt injection. By taking these steps, you can reduce the potential security risks associated with developer agents and better protect your systems and users.
>
> Block recognizes the important contributions our open source community makes. Part of keeping Block and its customers safe is by making sure that we find and fix any security issues found in our open source projects. If you find a security vulnerability, we encourage you to privately report it in the repositorys Security tab -> Report a vulnerability.
> AAIF (Agentic AI Foundation) recognizes the important contributions our open source community makes. Part of keeping goose and its users safe is by making sure that we find and fix any security issues found in our open source projects. If you find a security vulnerability, we encourage you to privately report it in the repositorys Security tab -> Report a vulnerability.
>
> Please see [privately reporting a security vulnerability](https://docs.github.com/en/code-security/security-advisories/guidance-on-reporting-and-writing-information-about-vulnerabilities/privately-reporting-a-security-vulnerability#privately-reporting-a-security-vulnerability) for more information. For assistance or escalation, please contact the [Block Open Source Governance Committee](mailto:open-source-governance@block.xyz)
> Please see [privately reporting a security vulnerability](https://docs.github.com/en/code-security/security-advisories/guidance-on-reporting-and-writing-information-about-vulnerabilities/privately-reporting-a-security-vulnerability#privately-reporting-a-security-vulnerability) for more information. For assistance or escalation, please contact the [AAIF Open Source Governance Committee](mailto:open-source-governance@block.xyz)
+2 -2
View File
@@ -69,7 +69,7 @@ const GITHUB_ACTIONS_ISSUER: &str = "https://token.actions.githubusercontent.com
async fn fetch_attestations(digest: &str, token: Option<&str>) -> Result<Vec<serde_json::Value>> {
let url = format!(
"https://api.github.com/repos/block/goose/attestations/sha256:{digest}\
"https://api.github.com/repos/aaif-goose/goose/attestations/sha256:{digest}\
?per_page=30&predicate_type=https://slsa.dev/provenance/v1"
);
@@ -209,7 +209,7 @@ pub async fn update(canary: bool, reconfigure: bool) -> Result<()> {
{
let tag = if canary { "canary" } else { "stable" };
let asset = asset_name();
let url = format!("https://github.com/block/goose/releases/download/{tag}/{asset}");
let url = format!("https://github.com/aaif-goose/goose/releases/download/{tag}/{asset}");
println!("Downloading {asset} from {tag} release...");
+1 -1
View File
@@ -665,7 +665,7 @@ pub async fn build_session(session_config: SessionBuilderConfig) -> CliSession {
"Error {}.\n\
Please check your system keychain and run 'goose configure' again.\n\
If your system is unable to use the keyring, please try setting secret key(s) via environment variables.\n\
For more info, see: https://block.github.io/goose/docs/troubleshooting/#keychainkeyring-errors",
For more info, see: https://goose-docs.ai/docs/troubleshooting/#keychainkeyring-errors",
e
));
process::exit(1);
+2
View File
@@ -3,6 +3,8 @@ use once_cell::sync::Lazy;
use rmcp::{ServerHandler, ServiceExt};
use std::collections::HashMap;
// NOTE: "Block" is kept here for backwards compatibility with existing
// user config/data directories. Changing this would orphan existing installations.
pub static APP_STRATEGY: Lazy<AppStrategyArgs> = Lazy::new(|| AppStrategyArgs {
top_level_domain: "Block".to_string(),
author: "Block".to_string(),
+1 -1
View File
@@ -4,7 +4,7 @@
"title": "goose-server",
"description": "An AI agent",
"contact": {
"name": "Block",
"name": "AAIF",
"email": "ai-oss-tools@block.xyz"
},
"license": {
@@ -15,11 +15,11 @@ Do NOT use this skill for:
## Steps (COMPLETE ALL BEFORE RESPONDING)
1. **Fetch official docs**
- Fetch the doc map from `https://block.github.io/goose/goose-docs-map.md`
- Fetch the doc map from `https://goose-docs.ai/goose-docs-map.md`
- Search the doc map for pages relevant to the user's topic and get the paths for these pages
- Use the EXACT paths from the doc map. For example:
- If doc map shows: `docs/guides/sessions/session-management.md`
- Fetch: `https://block.github.io/goose/docs/guides/sessions/session-management.md`
- Fetch: `https://goose-docs.ai/docs/guides/sessions/session-management.md`
- Do NOT modify or guess paths.
- **ONLY fetch paths that are explicitly listed in the doc map - do not guess or infer URLs**
- Make multiple fetch calls in parallel and save to temp files
@@ -53,4 +53,4 @@ Do NOT use this skill for:
5. **List documentation links**
- Only include docs actually used
- Remove `.md` suffix from URLs
- Example: If you fetched `https://block.github.io/goose/docs/guides/sessions/session-management.md`, list it as `https://block.github.io/goose/docs/guides/sessions/session-management`
- Example: If you fetched `https://goose-docs.ai/docs/guides/sessions/session-management.md`, list it as `https://goose-docs.ai/docs/guides/sessions/session-management`
@@ -2,7 +2,7 @@
source: crates/goose/src/agents/prompt_manager.rs
expression: system_prompt
---
You are a general-purpose AI agent called goose, created by Block, the parent company of Square, CashApp, and Tidal.
You are a general-purpose AI agent called goose, created by AAIF (Agentic AI Foundation).
goose is being developed as an open-source software project.
# Extensions
@@ -2,7 +2,7 @@
source: crates/goose/src/agents/prompt_manager.rs
expression: system_prompt
---
You are a general-purpose AI agent called goose, created by Block, the parent company of Square, CashApp, and Tidal.
You are a general-purpose AI agent called goose, created by AAIF (Agentic AI Foundation).
goose is being developed as an open-source software project.
# Extensions
@@ -2,7 +2,7 @@
source: crates/goose/src/agents/prompt_manager.rs
expression: system_prompt
---
You are a general-purpose AI agent called goose, created by Block, the parent company of Square, CashApp, and Tidal.
You are a general-purpose AI agent called goose, created by AAIF (Agentic AI Foundation).
goose is being developed as an open-source software project.
# Extensions
@@ -2,7 +2,7 @@
source: crates/goose/src/agents/prompt_manager.rs
expression: system_prompt
---
You are a general-purpose AI agent called goose, created by Block, the parent company of Square, CashApp, and Tidal.
You are a general-purpose AI agent called goose, created by AAIF (Agentic AI Foundation).
goose is being developed as an open-source software project.
# Extensions
+3
View File
@@ -13,6 +13,9 @@ impl Paths {
DirType::State => base.join("state"),
}
} else {
// NOTE: "Block" is kept here for backwards compatibility with existing
// user config/data directories (e.g. ~/Library/Application Support/Block/goose/).
// Changing this would orphan existing installations.
let strategy = choose_app_strategy(AppStrategyArgs {
top_level_domain: "Block".to_string(),
author: "Block".to_string(),
@@ -87,7 +87,7 @@ impl PkceAuthFlow {
let response = client
.post(TETRATE_TOKEN_URL)
.header("X-Title", "goose")
.header("Referer", "https://github.com/block/goose")
.header("Referer", "https://github.com/aaif-goose/goose")
.json(&request_body)
.send()
.await?;
+1 -1
View File
@@ -1,4 +1,4 @@
You are a specialized subagent within the goose AI framework, created by Block. You were spawned by the main goose agent to handle a specific task efficiently.
You are a specialized subagent within the goose AI framework, created by AAIF (Agentic AI Foundation). You were spawned by the main goose agent to handle a specific task efficiently.
# Your Role
You are an autonomous subagent with these characteristics:
+1 -1
View File
@@ -1,4 +1,4 @@
You are a general-purpose AI agent called goose, created by Block, the parent company of Square, CashApp, and Tidal.
You are a general-purpose AI agent called goose, created by AAIF (Agentic AI Foundation).
goose is being developed as an open-source software project.
{% if not code_execution_mode %}
@@ -1,4 +1,4 @@
You are goose, an autonomous AI agent created by Block. You act on the user's
You are goose, an autonomous AI agent created by AAIF (Agentic AI Foundation). You act on the user's
behalf — you do not explain how to do things, you DO them directly.
The OS is {{os}}, the shell is {{shell}}, and the working directory is {{working_directory}}
+1 -1
View File
@@ -57,7 +57,7 @@ impl OpenRouterProvider {
let auth = AuthMethod::BearerToken(api_key);
let api_client = ApiClient::new(host, auth)?
.with_header("HTTP-Referer", "https://block.github.io/goose")?
.with_header("HTTP-Referer", "https://goose-docs.ai")?
.with_header("X-Title", "goose")?;
Ok(Self {
+1 -1
View File
@@ -55,7 +55,7 @@ impl TetrateProvider {
let auth = AuthMethod::BearerToken(api_key);
let api_client = ApiClient::new(host, auth)?
.with_header("HTTP-Referer", "https://block.github.io/goose")?
.with_header("HTTP-Referer", "https://goose-docs.ai")?
.with_header("X-Title", "goose")?;
Ok(Self {
@@ -8,5 +8,5 @@ STDOUT: {"jsonrpc":"2.0","id":0,"result":{"capabilities":{"completions":{},"logg
STDIN: {"jsonrpc":"2.0","method":"notifications/initialized"}
STDERR: time=2025-12-11T17:58:47.642-05:00 level=INFO msg="session initialized"
STDIN: {"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"_meta":{"agent-session-id":"test-session-id","progressToken":0},"name":"get_file_contents","arguments":{"owner":"block","path":"README.md","repo":"goose","sha":"ab62b863c1666232a67048b6c4e10007a2a5b83c"}}}
STDOUT: {"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text","text":"successfully downloaded text file (SHA: de9bdde7f260549bf3a083651842f30ab29cf4e9)"},{"type":"resource","resource":{"uri":"repo://block/goose/sha/ab62b863c1666232a67048b6c4e10007a2a5b83c/contents/README.md","mimeType":"text/plain; charset=utf-8","text":"\u003cdiv align=\"center\"\u003e\n\n# goose\n\n_a local, extensible, open source AI agent that automates engineering tasks_\n\n\u003cp align=\"center\"\u003e\n \u003ca href=\"https://opensource.org/licenses/Apache-2.0\"\u003e\n \u003cimg src=\"https://img.shields.io/badge/License-Apache_2.0-blue.svg\"\u003e\n \u003c/a\u003e\n \u003ca href=\"https://discord.gg/7GaTvbDwga\"\u003e\n \u003cimg src=\"https://img.shields.io/discord/1287729918100246654?logo=discord\u0026logoColor=white\u0026label=Join+Us\u0026color=blueviolet\" alt=\"Discord\"\u003e\n \u003c/a\u003e\n \u003ca href=\"https://github.com/block/goose/actions/workflows/ci.yml\"\u003e\n \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/block/goose/ci.yml?branch=main\" alt=\"CI\"\u003e\n \u003c/a\u003e\n\u003c/p\u003e\n\u003c/div\u003e\n\ngoose is your on-machine AI agent, capable of automating complex development tasks from start to finish. More than just code suggestions, goose can build entire projects from scratch, write and execute code, debug failures, orchestrate workflows, and interact with external APIs - _autonomously_.\n\nWhether you're prototyping an idea, refining existing code, or managing intricate engineering pipelines, goose adapts to your workflow and executes tasks with precision.\n\nDesigned for maximum flexibility, goose works with any LLM and supports multi-model configuration to optimize performance and cost, seamlessly integrates with MCP servers, and is available as both a desktop app as well as CLI - making it the ultimate AI assistant for developers who want to move faster and focus on innovation.\n\n[![Watch the video](https://github.com/user-attachments/assets/ddc71240-3928-41b5-8210-626dfb28af7a)](https://youtu.be/D-DpDunrbpo)\n\n# Quick Links\n- [Quickstart](https://block.github.io/goose/docs/quickstart)\n- [Installation](https://block.github.io/goose/docs/getting-started/installation)\n- [Tutorials](https://block.github.io/goose/docs/category/tutorials)\n- [Documentation](https://block.github.io/goose/docs/category/getting-started)\n\n\n# a little goose humor 🦢\n\n\u003e Why did the developer choose goose as their AI agent?\n\u003e \n\u003e Because it always helps them \"migrate\" their code to production! 🚀\n\n# goose around with us\n- [Discord](https://discord.gg/block-opensource)\n- [YouTube](https://www.youtube.com/@goose-oss)\n- [LinkedIn](https://www.linkedin.com/company/goose-oss)\n- [Twitter/X](https://x.com/goose_oss)\n- [Bluesky](https://bsky.app/profile/opensource.block.xyz)\n- [Nostr](https://njump.me/opensource@block.xyz)\n"}}]}}
STDOUT: {"jsonrpc":"2.0","id":1,"result":{"content":[{"type":"text","text":"successfully downloaded text file (SHA: de9bdde7f260549bf3a083651842f30ab29cf4e9)"},{"type":"resource","resource":{"uri":"repo://block/goose/sha/ab62b863c1666232a67048b6c4e10007a2a5b83c/contents/README.md","mimeType":"text/plain; charset=utf-8","text":"\u003cdiv align=\"center\"\u003e\n\n# goose\n\n_a local, extensible, open source AI agent that automates engineering tasks_\n\n\u003cp align=\"center\"\u003e\n \u003ca href=\"https://opensource.org/licenses/Apache-2.0\"\u003e\n \u003cimg src=\"https://img.shields.io/badge/License-Apache_2.0-blue.svg\"\u003e\n \u003c/a\u003e\n \u003ca href=\"https://discord.gg/7GaTvbDwga\"\u003e\n \u003cimg src=\"https://img.shields.io/discord/1287729918100246654?logo=discord\u0026logoColor=white\u0026label=Join+Us\u0026color=blueviolet\" alt=\"Discord\"\u003e\n \u003c/a\u003e\n \u003ca href=\"https://github.com/block/goose/actions/workflows/ci.yml\"\u003e\n \u003cimg src=\"https://img.shields.io/github/actions/workflow/status/block/goose/ci.yml?branch=main\" alt=\"CI\"\u003e\n \u003c/a\u003e\n\u003c/p\u003e\n\u003c/div\u003e\n\ngoose is your on-machine AI agent, capable of automating complex development tasks from start to finish. More than just code suggestions, goose can build entire projects from scratch, write and execute code, debug failures, orchestrate workflows, and interact with external APIs - _autonomously_.\n\nWhether you're prototyping an idea, refining existing code, or managing intricate engineering pipelines, goose adapts to your workflow and executes tasks with precision.\n\nDesigned for maximum flexibility, goose works with any LLM and supports multi-model configuration to optimize performance and cost, seamlessly integrates with MCP servers, and is available as both a desktop app as well as CLI - making it the ultimate AI assistant for developers who want to move faster and focus on innovation.\n\n[![Watch the video](https://github.com/user-attachments/assets/ddc71240-3928-41b5-8210-626dfb28af7a)](https://youtu.be/D-DpDunrbpo)\n\n# Quick Links\n- [Quickstart](https://goose-docs.ai/docs/quickstart)\n- [Installation](https://goose-docs.ai/docs/getting-started/installation)\n- [Tutorials](https://goose-docs.ai/docs/category/tutorials)\n- [Documentation](https://goose-docs.ai/docs/category/getting-started)\n\n\n# a little goose humor 🦢\n\n\u003e Why did the developer choose goose as their AI agent?\n\u003e \n\u003e Because it always helps them \"migrate\" their code to production! 🚀\n\n# goose around with us\n- [Discord](https://discord.gg/block-opensource)\n- [YouTube](https://www.youtube.com/@goose-oss)\n- [LinkedIn](https://www.linkedin.com/company/goose-oss)\n- [Twitter/X](https://x.com/goose_oss)\n- [Bluesky](https://bsky.app/profile/opensource.block.xyz)\n- [Nostr](https://njump.me/opensource@block.xyz)\n"}}]}}
STDERR: time=2025-12-11T17:58:48.133-05:00 level=INFO msg="server session disconnected" session_id=""
@@ -10,7 +10,7 @@
"resource": {
"uri": "repo://block/goose/sha/ab62b863c1666232a67048b6c4e10007a2a5b83c/contents/README.md",
"mimeType": "text/plain; charset=utf-8",
"text": "<div align=\"center\">\n\n# goose\n\n_a local, extensible, open source AI agent that automates engineering tasks_\n\n<p align=\"center\">\n <a href=\"https://opensource.org/licenses/Apache-2.0\">\n <img src=\"https://img.shields.io/badge/License-Apache_2.0-blue.svg\">\n </a>\n <a href=\"https://discord.gg/7GaTvbDwga\">\n <img src=\"https://img.shields.io/discord/1287729918100246654?logo=discord&logoColor=white&label=Join+Us&color=blueviolet\" alt=\"Discord\">\n </a>\n <a href=\"https://github.com/block/goose/actions/workflows/ci.yml\">\n <img src=\"https://img.shields.io/github/actions/workflow/status/block/goose/ci.yml?branch=main\" alt=\"CI\">\n </a>\n</p>\n</div>\n\ngoose is your on-machine AI agent, capable of automating complex development tasks from start to finish. More than just code suggestions, goose can build entire projects from scratch, write and execute code, debug failures, orchestrate workflows, and interact with external APIs - _autonomously_.\n\nWhether you're prototyping an idea, refining existing code, or managing intricate engineering pipelines, goose adapts to your workflow and executes tasks with precision.\n\nDesigned for maximum flexibility, goose works with any LLM and supports multi-model configuration to optimize performance and cost, seamlessly integrates with MCP servers, and is available as both a desktop app as well as CLI - making it the ultimate AI assistant for developers who want to move faster and focus on innovation.\n\n[![Watch the video](https://github.com/user-attachments/assets/ddc71240-3928-41b5-8210-626dfb28af7a)](https://youtu.be/D-DpDunrbpo)\n\n# Quick Links\n- [Quickstart](https://block.github.io/goose/docs/quickstart)\n- [Installation](https://block.github.io/goose/docs/getting-started/installation)\n- [Tutorials](https://block.github.io/goose/docs/category/tutorials)\n- [Documentation](https://block.github.io/goose/docs/category/getting-started)\n\n\n# a little goose humor 🦢\n\n> Why did the developer choose goose as their AI agent?\n> \n> Because it always helps them \"migrate\" their code to production! 🚀\n\n# goose around with us\n- [Discord](https://discord.gg/block-opensource)\n- [YouTube](https://www.youtube.com/@goose-oss)\n- [LinkedIn](https://www.linkedin.com/company/goose-oss)\n- [Twitter/X](https://x.com/goose_oss)\n- [Bluesky](https://bsky.app/profile/opensource.block.xyz)\n- [Nostr](https://njump.me/opensource@block.xyz)\n"
"text": "<div align=\"center\">\n\n# goose\n\n_a local, extensible, open source AI agent that automates engineering tasks_\n\n<p align=\"center\">\n <a href=\"https://opensource.org/licenses/Apache-2.0\">\n <img src=\"https://img.shields.io/badge/License-Apache_2.0-blue.svg\">\n </a>\n <a href=\"https://discord.gg/7GaTvbDwga\">\n <img src=\"https://img.shields.io/discord/1287729918100246654?logo=discord&logoColor=white&label=Join+Us&color=blueviolet\" alt=\"Discord\">\n </a>\n <a href=\"https://github.com/block/goose/actions/workflows/ci.yml\">\n <img src=\"https://img.shields.io/github/actions/workflow/status/block/goose/ci.yml?branch=main\" alt=\"CI\">\n </a>\n</p>\n</div>\n\ngoose is your on-machine AI agent, capable of automating complex development tasks from start to finish. More than just code suggestions, goose can build entire projects from scratch, write and execute code, debug failures, orchestrate workflows, and interact with external APIs - _autonomously_.\n\nWhether you're prototyping an idea, refining existing code, or managing intricate engineering pipelines, goose adapts to your workflow and executes tasks with precision.\n\nDesigned for maximum flexibility, goose works with any LLM and supports multi-model configuration to optimize performance and cost, seamlessly integrates with MCP servers, and is available as both a desktop app as well as CLI - making it the ultimate AI assistant for developers who want to move faster and focus on innovation.\n\n[![Watch the video](https://github.com/user-attachments/assets/ddc71240-3928-41b5-8210-626dfb28af7a)](https://youtu.be/D-DpDunrbpo)\n\n# Quick Links\n- [Quickstart](https://goose-docs.ai/docs/quickstart)\n- [Installation](https://goose-docs.ai/docs/getting-started/installation)\n- [Tutorials](https://goose-docs.ai/docs/category/tutorials)\n- [Documentation](https://goose-docs.ai/docs/category/getting-started)\n\n\n# a little goose humor 🦢\n\n> Why did the developer choose goose as their AI agent?\n> \n> Because it always helps them \"migrate\" their code to production! 🚀\n\n# goose around with us\n- [Discord](https://discord.gg/block-opensource)\n- [YouTube](https://www.youtube.com/@goose-oss)\n- [LinkedIn](https://www.linkedin.com/company/goose-oss)\n- [Twitter/X](https://x.com/goose_oss)\n- [Bluesky](https://bsky.app/profile/opensource.block.xyz)\n- [Nostr](https://njump.me/opensource@block.xyz)\n"
}
}
]
+1 -1
View File
@@ -7,7 +7,7 @@ unmaintained = "none"
unsound = "none"
# Ignore proc-macro-error unmaintained warning
# See: https://github.com/block/goose/issues/7008
# See: https://github.com/aaif-goose/goose/issues/7008
ignore = [
"RUSTSEC-2023-0071", # rsa: Marvin Attack timing sidechannel (no safe upgrade available, via jsonwebtoken)
]
@@ -4,7 +4,7 @@ Automated pipeline for detecting and documenting CLI command changes between goo
## Overview
This automation keeps the [CLI Commands Guide](https://block.github.io/goose/docs/guides/goose-cli-commands) synchronized with code changes by:
This automation keeps the [CLI Commands Guide](https://goose-docs.ai/docs/guides/goose-cli-commands) synchronized with code changes by:
1. **Extracting** CLI structure from goose binary using `--help` output (deterministic)
2. **Detecting** changes between versions (deterministic diff)
@@ -32,7 +32,7 @@ download_release_binary() {
echo "Downloading goose $version from GitHub releases..." >&2
# Use the official download script with custom bin dir and specific version
curl -fsSL "https://github.com/block/goose/releases/download/stable/download_cli.sh" | \
curl -fsSL "https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh" | \
CONFIGURE=false GOOSE_BIN_DIR="$bin_dir" GOOSE_VERSION="$version" bash >&2 2>&1 || {
echo "Error: Failed to download goose $version" >&2
return 1
@@ -15,7 +15,7 @@ GOOSE_REPO=${GOOSE_REPO:-"$HOME/Development/goose"}
# Function to get release tags using gh CLI
get_latest_release() {
if command -v gh &> /dev/null; then
gh release list --repo block/goose --limit 1 --json tagName --jq '.[0].tagName' 2>/dev/null
gh release list --repo aaif-goose/goose --limit 1 --json tagName --jq '.[0].tagName' 2>/dev/null
else
# Fallback: get latest version tag from git
cd "$GOOSE_REPO" && git tag --sort=-v:refname | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | head -1
@@ -24,7 +24,7 @@ get_latest_release() {
get_previous_release() {
if command -v gh &> /dev/null; then
gh release list --repo block/goose --limit 2 --json tagName --jq '.[].tagName' 2>/dev/null | sed -n '2p'
gh release list --repo aaif-goose/goose --limit 2 --json tagName --jq '.[].tagName' 2>/dev/null | sed -n '2p'
else
# Fallback: get second-latest version tag from git
cd "$GOOSE_REPO" && git tag --sort=-v:refname | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | sed -n '2p'
@@ -4,7 +4,7 @@ Automated pipeline for detecting and documenting Recipe schema and validation ru
## Overview
This automation keeps the [Recipe Reference Guide](https://block.github.io/goose/docs/guides/recipes/recipe-reference) synchronized with code changes by:
This automation keeps the [Recipe Reference Guide](https://goose-docs.ai/docs/guides/recipes/recipe-reference) synchronized with code changes by:
1. **Extracting** schema and validation rules from source code (deterministic)
2. **Detecting** changes between versions (deterministic diff)
@@ -11,7 +11,7 @@ authors:
I'm a developer at heart, so when I'm working on a personal project, the hardest part isn't writing code—it's making design decisions. I recently built a calendar user interface. I wanted to enhance its visual appeal, so I researched UI design trends like "glassmorphism" and "claymorphism."
However, I didn't want to spend hours implementing the CSS for each design trend, so I developed a faster approach: screenshot-driven development. I used an open source developer agent called [goose](https://github.com/block/goose) to transform my user interfaces quickly.
However, I didn't want to spend hours implementing the CSS for each design trend, so I developed a faster approach: screenshot-driven development. I used an open source developer agent called [goose](https://github.com/aaif-goose/goose) to transform my user interfaces quickly.
<!-- truncate -->
@@ -205,7 +205,7 @@ export ANTHROPIC_API_KEY=your_api_key
```
### Step 4: Enable the Screen toolkit
goose uses [toolkits](https://block.github.io/goose/plugins/plugins.html) to extend its capabilities. The [screen](https://block.github.io/goose/plugins/available-toolkits.html#6-screen-toolkit) toolkit lets goose take and analyze screenshots.
goose uses [toolkits](https://goose-docs.ai/plugins/plugins.html) to extend its capabilities. The [screen](https://goose-docs.ai/plugins/available-toolkits.html#6-screen-toolkit) toolkit lets goose take and analyze screenshots.
To enable the Screen toolkit, add it to your goose profile at ~/.config/goose/profiles.yaml.
@@ -281,17 +281,17 @@ Developing user interfaces is a blend of creativity and problem-solving. And I l
Beyond prototyping, goose's ability to analyze screenshots can help developers identify and resolve UI bugs.
If you're interested in learning more, check out the [goose repo](https://github.com/block/goose) and join our [Discord community](https://discord.gg/goose-oss).
If you're interested in learning more, check out the [goose repo](https://github.com/aaif-goose/goose) and join our [Discord community](https://discord.gg/goose-oss).
<head>
<meta property="og:title" content="Screenshot-Driven Development" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2024/11/22/screenshot-driven-development" />
<meta property="og:url" content="https://goose-docs.ai/blog/2024/11/22/screenshot-driven-development" />
<meta property="og:description" content="AI Agent uses screenshots to assist in styling." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/screenshot-driven-development-4ed1beaa10c6062c0bf87e2d27590ad6.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/screenshot-driven-development-4ed1beaa10c6062c0bf87e2d27590ad6.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Screenshot-Driven Development" />
<meta name="twitter:description" content="AI Agent uses screenshots to assist in styling." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/screenshot-driven-development-4ed1beaa10c6062c0bf87e2d27590ad6.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/screenshot-driven-development-4ed1beaa10c6062c0bf87e2d27590ad6.png" />
</head>
@@ -47,18 +47,18 @@ goose now has an electron-based GUI macOS application that provides and alternat
goose v1.0 Beta now uses a custom protocol, that is designed in parallel with [Anthropics Model Context Protocol](https://www.anthropic.com/news/model-context-protocol) (MCP) to communicate with Systems. This makes it possible for developers to create their own systems (e.g Jira, ) that Goose can integrate with.
Excited for many more feature updates and improvements? Stay tuned for more updates on Goose! Check out the [goose repo](https://github.com/block/goose) and join our [Discord community](https://discord.gg/goose-oss).
Excited for many more feature updates and improvements? Stay tuned for more updates on Goose! Check out the [goose repo](https://github.com/aaif-goose/goose) and join our [Discord community](https://discord.gg/goose-oss).
<head>
<meta property="og:title" content="Previewing Goose v1.0 Beta" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2024/12/06/previewing-goose-v10-beta" />
<meta property="og:url" content="https://goose-docs.ai/blog/2024/12/06/previewing-goose-v10-beta" />
<meta property="og:description" content="AI Agent uses screenshots to assist in styling." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/goose-v1.0-beta-5d469fa73edea37cfccfe8a8ca0b47e2.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/goose-v1.0-beta-5d469fa73edea37cfccfe8a8ca0b47e2.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Screenshot-Driven Development" />
<meta name="twitter:description" content="AI Agent uses screenshots to assist in styling." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/goose-v1.0-beta-5d469fa73edea37cfccfe8a8ca0b47e2.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/goose-v1.0-beta-5d469fa73edea37cfccfe8a8ca0b47e2.png" />
</head>
@@ -22,7 +22,7 @@ This post was written about a beta version of goose and the commands and flow ma
Anthropic is leading the charge with the [Model Context Protocol (MCP)](https://modelcontextprotocol.io), an open standard that enables large language model (LLM) applications to connect with external systems, providing the necessary context for more informed and relevant AI interactions.
This is a game changer for AI agents such as [goose](https://block.github.io/goose/), which can perform tasks autonomously - a significant leap beyond chatbots that only provide step-by-step instructions. However, to unlock the full potential of these AI agents, we need a standard method for connecting them to external data sources. MCP provides this foundation.
This is a game changer for AI agents such as [goose](https://goose-docs.ai/), which can perform tasks autonomously - a significant leap beyond chatbots that only provide step-by-step instructions. However, to unlock the full potential of these AI agents, we need a standard method for connecting them to external data sources. MCP provides this foundation.
With MCP's standardized APIs and endpoints, goose can integrate seamlessly into your systems, enhancing its ability to perform complex tasks like debugging, writing code, and running commands directly in your environment.
@@ -30,7 +30,7 @@ With MCP's standardized APIs and endpoints, goose can integrate seamlessly into
### What's Possible
Without MCP, every [goose toolkit](https://block.github.io/goose/plugins/using-toolkits.html) developer would need to implement bespoke integrations with every system they need to connect to. Not only is this tedious and repetitive, but it delays the fun stuff.
Without MCP, every [goose toolkit](https://goose-docs.ai/plugins/using-toolkits.html) developer would need to implement bespoke integrations with every system they need to connect to. Not only is this tedious and repetitive, but it delays the fun stuff.
Let's take a simple GitHub workflow, for example. goose interacts directly with the GitHub API using custom scripts or configurations. Developers must configure goose to authenticate with GitHub and specify endpoints for actions like fetching open pull requests or adding comments. Each integration requires manual setup and custom coding to handle authentication tokens, error handling, and API updates.
@@ -38,7 +38,7 @@ MCP simplifies the process by providing a standardized interface for accessing G
### Join the Ecosystem
As MCP adoption expands, so does gooses potential to deliver even more powerful solutions for your organization. By [integrating goose](https://block.github.io/goose/) into your workflows and [embracing MCP](https://modelcontextprotocol.io/introduction), youre not just enhancing your own systems, youre contributing to the growth of an ecosystem that makes AI tools more interoperable, efficient, and impactful.
As MCP adoption expands, so does gooses potential to deliver even more powerful solutions for your organization. By [integrating goose](https://goose-docs.ai/) into your workflows and [embracing MCP](https://modelcontextprotocol.io/introduction), youre not just enhancing your own systems, youre contributing to the growth of an ecosystem that makes AI tools more interoperable, efficient, and impactful.
@@ -54,18 +54,18 @@ As MCP adoption expands, so does gooses potential to deliver even more powerf
<meta name="description" content="Learn how MCP standardizes integrations and fosters an ecosystem for the future of AI-enabled tools." />
<!-- Facebook Meta Tags -->
<meta property="og:url" content="https://block.github.io/goose/blog/2024/12/10/connecting-ai-agents-to-your-systems-with-mcp" />
<meta property="og:url" content="https://goose-docs.ai/blog/2024/12/10/connecting-ai-agents-to-your-systems-with-mcp" />
<meta property="og:type" content="website" />
<meta property="og:title" content="Connecting AI Agents to Your Systems with MCP" />
<meta property="og:description" content="Learn how MCP standardizes integrations and fosters an ecosystem for the future of AI-enabled tools." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/goose-mcp-34a5252d18d18dff26157d673f7af779.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/goose-mcp-34a5252d18d18dff26157d673f7af779.png" />
<!-- Twitter Meta Tags -->
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io" />
<meta property="twitter:url" content="https://block.github.io/goose/blog/2024/12/10/connecting-ai-agents-to-your-systems-with-mcp" />
<meta property="twitter:domain" content="aaif-goose.github.io" />
<meta property="twitter:url" content="https://goose-docs.ai/blog/2024/12/10/connecting-ai-agents-to-your-systems-with-mcp" />
<meta name="twitter:title" content="Connecting AI Agents to Your Systems with MCP" />
<meta name="twitter:description" content="Learn how MCP standardizes integrations and fosters an ecosystem for the future of AI-enabled tools." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/goose-mcp-34a5252d18d18dff26157d673f7af779.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/goose-mcp-34a5252d18d18dff26157d673f7af779.png" />
</head>
@@ -162,12 +162,12 @@ Try it out, and let goose handle the heavy lifting of CI debugging for you!
<head>
<meta property="og:title" content="Resolving CI Issues with goose: A Practical Walkthrough" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2024/12/11/resolving-ci-issues-with-goose-a-practical-walkthrough" />
<meta property="og:url" content="https://goose-docs.ai/blog/2024/12/11/resolving-ci-issues-with-goose-a-practical-walkthrough" />
<meta property="og:description" content="Leverage goose to simplify your CI debugging process, fetch detailed information about failed CI runs & annotations directly from GitHub, and even apply fixes directly." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/goose-github-ci-30930008ab57b0aebae15a03c73a12b5.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/goose-github-ci-30930008ab57b0aebae15a03c73a12b5.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Resolving CI Issues with goose: A Practical Walkthrough" />
<meta name="twitter:description" content="Leverage goose to simplify your CI debugging process, fetch detailed information about failed CI runs & annotations directly from GitHub, and even apply fixes directly." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/goose-github-ci-30930008ab57b0aebae15a03c73a12b5.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/goose-github-ci-30930008ab57b0aebae15a03c73a12b5.png" />
</head>
@@ -16,7 +16,7 @@ Powered by your choice of [large language models (LLMs)](/docs/getting-started/p
You can think of goose as an assistant that is ready to take your instructions, and do the work for you.
While goose's first use cases are engineering focused, the community has been exploring other non-engineering use cases for goose as well. And it goes without saying, goose is [open source](https://github.com/block/goose) 🎉.
While goose's first use cases are engineering focused, the community has been exploring other non-engineering use cases for goose as well. And it goes without saying, goose is [open source](https://github.com/aaif-goose/goose) 🎉.
## How goose Works
@@ -52,7 +52,7 @@ You can get started using goose right away! Check out our [Quickstart](/docs/qui
Excited for upcoming features and events? Be sure to connect with us!
- [GitHub](https://github.com/block/goose)
- [GitHub](https://github.com/aaif-goose/goose)
- [Discord](https://discord.gg/goose-oss)
- [YouTube](https://www.youtube.com/@goose-oss)
- [LinkedIn](https://www.linkedin.com/company/goose-oss)
@@ -60,18 +60,18 @@ Excited for upcoming features and events? Be sure to connect with us!
- [BlueSky](https://bsky.app/profile/opensource.block.xyz)
[extensions-directory]: https://block.github.io/goose/v1/extensions
[extensions-directory]: https://goose-docs.ai/v1/extensions
<head>
<meta property="og:title" content="Introducing codename goose" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2024/12/11/resolving-ci-issues-with-goose-a-practical-walkthrough" />
<meta property="og:url" content="https://goose-docs.ai/blog/2024/12/11/resolving-ci-issues-with-goose-a-practical-walkthrough" />
<meta property="og:description" content="codename goose is your open source AI agent, automating engineering tasks and improving productivity." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/introducing-codename-goose-89cac25816e0ea215dd47d4b9768c8ab.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/introducing-codename-goose-89cac25816e0ea215dd47d4b9768c8ab.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Introducing codename goose" />
<meta name="twitter:description" content="codename goose is your open source AI agent, automating engineering tasks and improving productivity." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/introducing-codename-goose-89cac25816e0ea215dd47d4b9768c8ab.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/introducing-codename-goose-89cac25816e0ea215dd47d4b9768c8ab.png" />
</head>
@@ -149,12 +149,12 @@ Hopefully this has provided clear insight into what are AI agents, how they work
<head>
<meta property="og:title" content="Agentic AI and the MCP Ecosystem" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/02/17/agentic-ai-mcp" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/02/17/agentic-ai-mcp" />
<meta property="og:description" content="A 101 introduction to AI Agents" />
<meta property="og:image" content="https://block.github.io/goose/assets/images/agentic-ai-with-mcp-1e3050cc8d8ae7a620440e871ad9f0d2.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/agentic-ai-with-mcp-1e3050cc8d8ae7a620440e871ad9f0d2.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Agentic AI and the MCP Ecosystem" />
<meta name="twitter:description" content="A 101 introduction to AI Agents" />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/agentic-ai-with-mcp-1e3050cc8d8ae7a620440e871ad9f0d2.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/agentic-ai-with-mcp-1e3050cc8d8ae7a620440e871ad9f0d2.png" />
</head>
@@ -34,12 +34,12 @@ Hopefully this contribution inspired you as much as it inspired our community. I
<head>
<meta property="og:title" content="Let A Team of AI Agents Do It For You" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/02/17/gooseteam-mcp" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/02/17/gooseteam-mcp" />
<meta property="og:description" content="Community Spotlight on Cliff Hall's gooseTeam MCP server." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/gooseteam-mcp-082fa2890c313519c2a1637ca979c219.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/gooseteam-mcp-082fa2890c313519c2a1637ca979c219.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Let A Team of AI Agents Do It For You" />
<meta name="twitter:description" content="Community Spotlight on Cliff Hall's gooseTeam MCP server." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/gooseteam-mcp-082fa2890c313519c2a1637ca979c219.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/gooseteam-mcp-082fa2890c313519c2a1637ca979c219.png" />
</head>
@@ -86,12 +86,12 @@ By following these tips, you'll be able to work more effectively with goose, get
<head>
<meta property="og:title" content="6 Essential Tips for Working with goose" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/03/06/goose-tips" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/03/06/goose-tips" />
<meta property="og:description" content="Practical tips to help you use goose more effectively and efficiently." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/goose-tips-4add28cc7201737dfb468ad11980f070.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/goose-tips-4add28cc7201737dfb468ad11980f070.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="6 Essential Tips for Working with goose" />
<meta name="twitter:description" content="Practical tips to help you use goose more effectively and efficiently." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/goose-tips-4add28cc7201737dfb468ad11980f070.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/goose-tips-4add28cc7201737dfb468ad11980f070.png" />
</head>
@@ -38,12 +38,12 @@ For those eager to experiment with [VOYP](https://github.com/paulotaylor/voyp-mc
<head>
<meta property="og:title" content="Wild goose Case: Automating Phone Calls with goose and VOYP" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/03/06/goose-tips" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/03/06/goose-tips" />
<meta property="og:description" content="Give goose the ability to make phone calls with the VOYP extension." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/goose-voyp-215f3391cfbe2132542a2be63db84999.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/goose-voyp-215f3391cfbe2132542a2be63db84999.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Wild goose Case: Automating Phone Calls with goose and VOYP" />
<meta name="twitter:description" content="Give goose the ability to make phone calls with the VOYP extension." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/goose-voyp-215f3391cfbe2132542a2be63db84999.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/goose-voyp-215f3391cfbe2132542a2be63db84999.png" />
</head>
@@ -12,7 +12,7 @@ In our previous episode of [goose Flight School](https://www.youtube.com/playlis
<!--truncate-->
# How It Works
[Extensions](https://block.github.io/goose/docs/getting-started/using-extensions) enhance goose's functionality by connecting with your existing tools and workflows. They add new features, access external data resources, and integrate with other systems. Learn how multiple extensions, including Figma and Developer, worked together seamlessly to dramatically accelerate development.
[Extensions](https://goose-docs.ai/docs/getting-started/using-extensions) enhance goose's functionality by connecting with your existing tools and workflows. They add new features, access external data resources, and integrate with other systems. Learn how multiple extensions, including Figma and Developer, worked together seamlessly to dramatically accelerate development.
# Live Tutorial: goose Builds Live
During the livestream, Adewale demonstrated step-by-step how goose handled each development phase, from creating the basic application structure to generating responsive layouts using Tailwind CSS. Adewale also highlighted how goose addresses potential limitations as you go, showcasing the powerful balance between the goose's automation and developer control.
@@ -27,19 +27,19 @@ Throughout the stream, Adewale shared valuable tips to prepare your design for g
* make sure you thoroughly test for functionality and responsiveness
# Getting Started with goose and Figma
Whether you're a designer wanting to rapidly turn concepts into working code or a developer curious about streamlining design implementation, you can download goose with its built-in [Developer extension](https://block.github.io/goose/docs/getting-started/installation) and add the [Figma extension](https://block.github.io/goose/v1/extensions/).
Whether you're a designer wanting to rapidly turn concepts into working code or a developer curious about streamlining design implementation, you can download goose with its built-in [Developer extension](https://goose-docs.ai/docs/getting-started/installation) and add the [Figma extension](https://goose-docs.ai/v1/extensions/).
For step-by-step instructions, check out the [Figma tutorial](/docs/mcp/figma-mcp).
<head>
<meta property="og:title" content="goose Flight School: Turn Figma Designs Into Code With goose" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/03/12/goose-figma-mcp" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/03/12/goose-figma-mcp" />
<meta property="og:description" content="Give goose the ability to turn Figma designs into code with the Figma extension." />
<meta property="og:image" content="http://block.github.io/goose/assets/images/goosefigma-e6f84a734bd56cb431bb02452331a5d5.png" />
<meta property="og:image" content="http://goose-docs.ai/assets/images/goosefigma-e6f84a734bd56cb431bb02452331a5d5.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="goose Flight School: Turn Figma Designs Into Code With goose" />
<meta name="twitter:description" content="Give goose the ability to turn Figma designs into code with the Figma extension." />
<meta name="twitter:image" content="http://block.github.io/goose/assets/images/goosefigma-e6f84a734bd56cb431bb02452331a5d5.png" />
<meta name="twitter:image" content="http://goose-docs.ai/assets/images/goosefigma-e6f84a734bd56cb431bb02452331a5d5.png" />
</head>
@@ -17,9 +17,9 @@ Together, they create a self-contained AI agent workflow that puts advanced capa
# Getting Started
Before diving deep into various capabilities, Rizel walked us through how to set yourself up for success by integrating goose with Ollama. To follow along, you can [download goose](https://block.github.io/goose/) and follow a step-by-step walk through in the [Configure LLM Provider](https://block.github.io/goose/docs/getting-started/providers) guide.
Before diving deep into various capabilities, Rizel walked us through how to set yourself up for success by integrating goose with Ollama. To follow along, you can [download goose](https://goose-docs.ai/) and follow a step-by-step walk through in the [Configure LLM Provider](https://goose-docs.ai/docs/getting-started/providers) guide.
If you have any questions or get stuck, feel free to chat with us on [Discord](https://discord.gg/goose-oss) or post an issue/discussion on [GitHub](https://github.com/block/goose/). Thanks for reading!
If you have any questions or get stuck, feel free to chat with us on [Discord](https://discord.gg/goose-oss) or post an issue/discussion on [GitHub](https://github.com/aaif-goose/goose/). Thanks for reading!
# Why Go Local?
Using cloud-based LLMs and providers make it so you don't need substantial computing resources, so why go local? Here's some benefits you may want to consider:
@@ -88,12 +88,12 @@ The benefits of owning your AI experience can be compelling for a variety of use
<head>
<meta property="og:title" content="Goosing Around: AI, But Make It Local With goose and Ollama" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/03/13/goose-ollama-local" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/03/13/goose-ollama-local" />
<meta property="og:description" content="Integrate goose with Ollama for a fully local experience." />
<meta property="og:image" content="http://block.github.io/goose/assets/images/gooseollama-fbb2cb67117c81eaa189a6b6174e6c6c.png" />
<meta property="og:image" content="http://goose-docs.ai/assets/images/gooseollama-fbb2cb67117c81eaa189a6b6174e6c6c.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Goosing Around: AI, But Make It Local With goose and Ollama" />
<meta name="twitter:description" content="Integrate goose with Ollama for a fully local experience." />
<meta name="twitter:image" content="http://block.github.io/goose/assets/images/gooseollama-fbb2cb67117c81eaa189a6b6174e6c6c.png" />
<meta name="twitter:image" content="http://goose-docs.ai/assets/images/gooseollama-fbb2cb67117c81eaa189a6b6174e6c6c.png" />
</head>
@@ -44,7 +44,7 @@ As developers focus on operational efficiency, researchers can use the analytica
# The Future of AI Observability
These powerful debugging and analysis capabilities are only the beginning. This integration between goose and Langfuse represents a significant step forward in making AI agents as transparent and debuggable as traditional code.
To keep up with the exciting developments as they release, you can check out both of the [goose](https://github.com/block/goose) and [Langfuse](https://github.com/langfuse/langfuse) repositories on GitHub.
To keep up with the exciting developments as they release, you can check out both of the [goose](https://github.com/aaif-goose/goose) and [Langfuse](https://github.com/langfuse/langfuse) repositories on GitHub.
You can also watch the [livestream discussing the goose and Langfuse integration](https://www.youtube.com/live/W39BQjsTS9E?feature=shared), and follow the [tutorial showing you how to integrate Langfuse with goose](/docs/tutorials/langfuse).
@@ -53,12 +53,12 @@ Also, be sure to subscribe to our [events calendar](https://calget.com/c/t7jszri
<head>
<meta property="og:title" content="How goose Catches AI Errors with Langfuse" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/03/18/goose-langfuse" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/03/18/goose-langfuse" />
<meta property="og:description" content="Get detailed insights into goose's behavior with Langfuse's observability tools." />
<meta property="og:image" content="http://block.github.io/goose/assets/images/goose_aierrors-22154af884db86789ce1a12a72897e8e.png" />
<meta property="og:image" content="http://goose-docs.ai/assets/images/goose_aierrors-22154af884db86789ce1a12a72897e8e.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="How goose Catches AI Errors with Langfuse" />
<meta name="twitter:description" content="Get detailed insights into goose's behavior with Langfuse's observability tools." />
<meta name="twitter:image" content="http://block.github.io/goose/assets/images/goose_aierrors-22154af884db86789ce1a12a72897e8e.png" />
<meta name="twitter:image" content="http://goose-docs.ai/assets/images/goose_aierrors-22154af884db86789ce1a12a72897e8e.png" />
</head>
@@ -150,12 +150,12 @@ goose is here to make your life easier, so the next time you open up a session,
<head>
<meta property="og:title" content="AI Prompting 101: How to Get the Best Responses from Your AI Agent" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/03/13/better-ai-prompting" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/03/13/better-ai-prompting" />
<meta property="og:description" content="How to prompt and vibe code your way to better responses." />
<meta property="og:image" content="http://block.github.io/goose/assets/images/prompt-078b12695f95c4f0eac3861a8a2611ef.png" />
<meta property="og:image" content="http://goose-docs.ai/assets/images/prompt-078b12695f95c4f0eac3861a8a2611ef.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="AI Prompting 101: How to Get the Best Responses from Your AI Agent" />
<meta name="twitter:description" content="How to prompt and vibe code your way to better responses." />
<meta name="twitter:image" content="http://block.github.io/goose/assets/images/prompt-078b12695f95c4f0eac3861a8a2611ef.png" />
<meta name="twitter:image" content="http://goose-docs.ai/assets/images/prompt-078b12695f95c4f0eac3861a8a2611ef.png" />
</head>
@@ -43,12 +43,12 @@ This has been so extremely helpful in increasing my productivity. Thanks, Goose!
<head>
<meta property="og:title" content="MCP in Action: How I Use AI to Plan My Week with Goose, Asana, and Google Calendar" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/03/20/asana-calendar-mcp" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/03/20/asana-calendar-mcp" />
<meta property="og:description" content="Use MCPs with Goose to automate task management and enhance productivity." />
<meta property="og:image" content="http://block.github.io/goose/assets/images/mcp-planner-761303c5ddcd5c79ed853536e3f87bcf.png" />
<meta property="og:image" content="http://goose-docs.ai/assets/images/mcp-planner-761303c5ddcd5c79ed853536e3f87bcf.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="MCP in Action: How I Use AI to Plan My Week with Goose, Asana, and Google Calendar" />
<meta name="twitter:description" content="Use MCPs with Goose to automate task management and enhance productivity." />
<meta name="twitter:image" content="http://block.github.io/goose/assets/images/mcp-planner-761303c5ddcd5c79ed853536e3f87bcf.png" />
<meta name="twitter:image" content="http://goose-docs.ai/assets/images/mcp-planner-761303c5ddcd5c79ed853536e3f87bcf.png" />
</head>
@@ -12,7 +12,7 @@ authors:
**Answer: You get an electric night filled with great conversations, hands-on hacking, and mind-blowing insights into agentic systems.**
This week, we hosted our very first [Goose](https://block.github.io/goose) Meetup in Boston at the Cambridge Innovation Center. The turnout and energy exceeded all expectations! From first-time Goose users to seasoned AI engineers, attendees gathered to explore how Goose and the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) are shaping the future of AI automation.
This week, we hosted our very first [Goose](https://goose-docs.ai) Meetup in Boston at the Cambridge Innovation Center. The turnout and energy exceeded all expectations! From first-time Goose users to seasoned AI engineers, attendees gathered to explore how Goose and the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) are shaping the future of AI automation.
<!--truncate-->
@@ -110,12 +110,12 @@ _The Goose Team in Boston_
<head>
<meta property="og:title" content="Codename Goose Goes to Boston" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/03/21/goose-boston-meetup" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/03/21/goose-boston-meetup" />
<meta property="og:description" content="We hosted our first Goose Meetup in Boston, bringing together over 70 community members for lightning talks, hacking, and lively conversations about agentic systems and the future of MCPs." />
<meta property="og:image" content="http://block.github.io/goose/assets/images/goose_goes_to_boston_banner-3ef0eedeb9d3eac56907c0c5e615d919.png" />
<meta property="og:image" content="http://goose-docs.ai/assets/images/goose_goes_to_boston_banner-3ef0eedeb9d3eac56907c0c5e615d919.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Codename Goose Goes to Boston" />
<meta name="twitter:description" content="We hosted our first Goose Meetup in Boston, bringing together over 70 community members for lightning talks, hacking, and lively conversations about agentic systems and the future of MCPs." />
<meta name="twitter:image" content="http://block.github.io/goose/assets/images/goose_goes_to_boston_banner-3ef0eedeb9d3eac56907c0c5e615d919.png" />
<meta name="twitter:image" content="http://goose-docs.ai/assets/images/goose_goes_to_boston_banner-3ef0eedeb9d3eac56907c0c5e615d919.png" />
</head>
@@ -60,12 +60,12 @@ The project is open source, and welcomes contributions from the community. If yo
<head>
<meta property="og:title" content="Cracking the Code in VS Code" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/03/21/goose-vscode" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/03/21/goose-vscode" />
<meta property="og:description" content="Connect Goose directly to your code editor with this Visual Studio Code MCP." />
<meta property="og:image" content="http://block.github.io/goose/assets/images/vscodestream-74eafa34e7ae10cfb738feddecc98519.png" />
<meta property="og:image" content="http://goose-docs.ai/assets/images/vscodestream-74eafa34e7ae10cfb738feddecc98519.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Cracking the Code in VS Code" />
<meta name="twitter:description" content="Connect Goose directly to your code editor with this Visual Studio Code MCP." />
<meta name="twitter:image" content="http://block.github.io/goose/assets/images/vscodestream-74eafa34e7ae10cfb738feddecc98519.png" />
<meta name="twitter:image" content="http://goose-docs.ai/assets/images/vscodestream-74eafa34e7ae10cfb738feddecc98519.png" />
</head>
@@ -58,12 +58,12 @@ A quick glance at an MCP directory like Glama can save you from crying on your o
<head>
<meta property="og:title" content="How to Determine If An MCP Server Is Safe" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/03/26/mcp-security" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/03/26/mcp-security" />
<meta property="og:description" content="Before you plug your AI agent into just any MCP server, here's how to check if it's actually safe." />
<meta property="og:image" content="http://block.github.io/goose/assets/images/mcpsafety-87eb7ace7163a5edbe068ff75b79a199.png" />
<meta property="og:image" content="http://goose-docs.ai/assets/images/mcpsafety-87eb7ace7163a5edbe068ff75b79a199.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="How to Determine If An MCP Server Is Safe" />
<meta name="twitter:description" content="Before you plug your agent into just any MCP server, here's how to check if it's actually safe." />
<meta name="twitter:image" content="http://block.github.io/goose/assets/images/mcpsafety-87eb7ace7163a5edbe068ff75b79a199.png" />
<meta name="twitter:image" content="http://goose-docs.ai/assets/images/mcpsafety-87eb7ace7163a5edbe068ff75b79a199.png" />
</head>
@@ -84,12 +84,12 @@ Voice interactions with AI agents like Goose with the power and tools to act on
<head>
<meta property="og:title" content="Vibe Coding with Goose and the Speech MCP" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/03/28/vibe-coding-with-goose" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/03/28/vibe-coding-with-goose" />
<meta property="og:description" content="Explore the new Speech MCP server that enables voice-controlled coding and natural conversation with your AI agent." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/vibe-coding-b2efeed37ea43f4773da5f1ff96f4184.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/vibe-coding-b2efeed37ea43f4773da5f1ff96f4184.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Vibe Coding with Goose and the Speech MCP" />
<meta name="twitter:description" content="Explore the new Speech MCP server that enables voice-controlled coding and natural conversation with your AI agent." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/vibe-coding-b2efeed37ea43f4773da5f1ff96f4184.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/vibe-coding-b2efeed37ea43f4773da5f1ff96f4184.png" />
</head>
@@ -23,7 +23,7 @@ These community evals aren't the rigorous, peer-reviewed benchmarks that researc
In this spirit, we're introducing our **Goose Vibe Check** leaderboard.
Thank you to the Ollama team for their help and support in our experimentation contributing to this blog! We used Ollamas [structured outputs](https://ollama.com/blog/structured-outputs) feature to enable our [toolshim implementation](https://block.github.io/goose/docs/experimental/ollama) (more below) and their recently released [context length parameter override](https://github.com/ollama/ollama/blob/main/docs/faq.mdx#how-can-i-specify-the-context-window-size) to enable testing on longer contexts.
Thank you to the Ollama team for their help and support in our experimentation contributing to this blog! We used Ollamas [structured outputs](https://ollama.com/blog/structured-outputs) feature to enable our [toolshim implementation](https://goose-docs.ai/docs/experimental/ollama) (more below) and their recently released [context length parameter override](https://github.com/ollama/ollama/blob/main/docs/faq.mdx#how-can-i-specify-the-context-window-size) to enable testing on longer contexts.
## Leaderboard
@@ -136,7 +136,7 @@ Tool calling enables models to interact with [MCP extensions](https://github.com
### Evaluation Suites
Our evaluations are defined in the [Goose repository](https://github.com/block/goose/tree/main/crates/goose-bench/src/eval_suites) (PRs welcome to add additional evals!) and are grouped into two categories:
Our evaluations are defined in the [Goose repository](https://github.com/aaif-goose/goose/tree/main/crates/goose-bench/src/eval_suites) (PRs welcome to add additional evals!) and are grouped into two categories:
#### Core Suite
These evals focus on certain tasks fundamental to developer workflows:
@@ -237,7 +237,7 @@ However, this solution has limited performance due to:
- **Structured output interference:** Ollamas structured output feature influences the models token sampling process, where the output is impacted by the models fundamental ability to extract information and generate JSON appropriately.
Despite these challenges, there could be potential in fine-tuning these toolshim models to specifically optimize them for tool call generation.
If youd like to try out the toolshim, check out our [documentation](https://block.github.io/goose/docs/experimental/ollama)
If youd like to try out the toolshim, check out our [documentation](https://goose-docs.ai/docs/experimental/ollama)
## Practical Advice for Local Model Users
@@ -422,13 +422,13 @@ For runs that successfully created an index.html for the Wiki page task, here
<head>
<meta property="og:title" content="Community-Inspired Benchmarking: The Goose Vibe Check" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/03/31/goose-benchmark" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/03/31/goose-benchmark" />
<meta property="og:description" content="See how open source AI models measure up in our first Goose agent benchmark tests" />
<meta property="og:image" content="http://block.github.io/goose/assets/images/goose-benchmark-d9726c203290ef892fe3fe3adc7d898f.png" />
<meta property="og:image" content="http://goose-docs.ai/assets/images/goose-benchmark-d9726c203290ef892fe3fe3adc7d898f.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Community-Inspired Benchmarking: The Goose Vibe Check" />
<meta name="twitter:description" content="See how open source AI models measure up in our first Goose agent benchmark tests" />
<meta name="twitter:image" content="http://block.github.io/goose/assets/images/goose-benchmark-d9726c203290ef892fe3fe3adc7d898f.png" />
<meta name="twitter:image" content="http://goose-docs.ai/assets/images/goose-benchmark-d9726c203290ef892fe3fe3adc7d898f.png" />
</head>
@@ -176,12 +176,12 @@ Were excited to work on making this protocol more secure for users and develo
<head>
<meta property="og:title" content="Securing the Model Context Protocol" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/03/31/securing-mcp" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/03/31/securing-mcp" />
<meta property="og:description" content="Building secure and capable AI integrations with Model Context Protocol (MCP) at Block." />
<meta property="og:image" content="http://block.github.io/goose/assets/images/securing-mcp-5e475e91c0e621afa33e30b3d89ef065.png" />
<meta property="og:image" content="http://goose-docs.ai/assets/images/securing-mcp-5e475e91c0e621afa33e30b3d89ef065.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Securing the Model Context Protocol" />
<meta name="twitter:description" content="Building secure and capable AI integrations with Model Context Protocol (MCP) at Block." />
<meta name="twitter:image" content="http://block.github.io/goose/assets/images/securing-mcp-5e475e91c0e621afa33e30b3d89ef065.png" />
<meta name="twitter:image" content="http://goose-docs.ai/assets/images/securing-mcp-5e475e91c0e621afa33e30b3d89ef065.png" />
</head>
@@ -68,24 +68,24 @@ Asana: Create a new task in my Asana workspace called 'Review Q4 metrics' and se
GitHub: Create a new branch called hello-world in my angiejones/goose-demo repository. Update the README.md file to say "this was written by goose" and commit it. Open a pull request with your changes.
```
To see more examples just like this, along with the results you can get, check out this [Prompt Library](https://block.github.io/goose/prompt-library)! This is your central directory for discovering and using effective prompts with Goose.
To see more examples just like this, along with the results you can get, check out this [Prompt Library](https://goose-docs.ai/prompt-library)! This is your central directory for discovering and using effective prompts with Goose.
## The Possibilities Are Endless
While some are developed by official providers, a vast majority of MCP servers you see are actually developed by community members! Plus, because MCP is an open standard, anyone can build an MCP server for any resource. You could even use Goose to help you build one!
Hopefully now, instead of spending hours manually gathering data and creating your next marketing report, or manually sorting through your todo-backlog on a Monday, you will use MCP with Goose and have it done for you in minutes.
*To learn more about using MCP servers and Goose, check out the [Goose documentation](https://block.github.io/goose/docs/category/getting-started), or join the [Block Open Source Discord](https://discord.gg/goose-oss) to connect with other open source community members.*
*To learn more about using MCP servers and Goose, check out the [Goose documentation](https://goose-docs.ai/docs/category/getting-started), or join the [Block Open Source Discord](https://discord.gg/goose-oss) to connect with other open source community members.*
<head>
<meta property="og:title" content="MCP Explained for Non-Developers" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/04/01/mcp-nondevs" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/04/01/mcp-nondevs" />
<meta property="og:description" content="Learn what Model Context Protocol (MCP) is and how anyone can use it to save time on tasks." />
<meta property="og:image" content="http://block.github.io/goose/assets/images/mcp_nondevs-5ce7f39de923cab01de6e14e5dc06744.png" />
<meta property="og:image" content="http://goose-docs.ai/assets/images/mcp_nondevs-5ce7f39de923cab01de6e14e5dc06744.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="MCP Explained for Non-Developers" />
<meta name="twitter:description" content="Learn what Model Context Protocol (MCP) is and how anyone can use it to save time on tasks." />
<meta name="twitter:image" content="http://block.github.io/goose/assets/images/mcp_nondevs-5ce7f39de923cab01de6e14e5dc06744.png" />
<meta name="twitter:image" content="http://goose-docs.ai/assets/images/mcp_nondevs-5ce7f39de923cab01de6e14e5dc06744.png" />
</head>
@@ -89,12 +89,12 @@ What are your favorite MCP servers? How do you use them together? Share your exp
<head>
<meta property="og:title" content="Top 5 MCP Servers I Use as a Developer with Goose Extensions" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/04/01/top-5-mcp-servers" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/04/01/top-5-mcp-servers" />
<meta property="og:description" content="These 5 MCP servers help me automate my workflow and make me a better developer." />
<meta property="og:image" content="http://block.github.io/goose/assets/images/mcp-servers-cover-6994acb4dec5a3b33d10ea61f7609e4b.png" />
<meta property="og:image" content="http://goose-docs.ai/assets/images/mcp-servers-cover-6994acb4dec5a3b33d10ea61f7609e4b.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Top 5 MCP Servers I Use as a Developer with Goose Extensions" />
<meta name="twitter:description" content="These 5 MCP servers help me automate my workflow and make me a better developer." />
<meta name="twitter:image" content="http://block.github.io/goose/assets/images/mcp-servers-cover-6994acb4dec5a3b33d10ea61f7609e4b.png" />
<meta name="twitter:image" content="http://goose-docs.ai/assets/images/mcp-servers-cover-6994acb4dec5a3b33d10ea61f7609e4b.png" />
</head>
@@ -38,7 +38,7 @@ This creative freedom comes with significant risks. Many developers have encount
## A Better Way to Vibe Code with Goose
[Goose](https://block.github.io/goose) is an open source AI agent local to your machine with built-in features for safe vibe coding.
[Goose](https://goose-docs.ai) is an open source AI agent local to your machine with built-in features for safe vibe coding.
:::note
Most folks define "vibe coding" as purely chaotic development with no rules. I'm redefining it as flowing with AI while protecting your project, team, and future self.
@@ -46,7 +46,7 @@ Most folks define "vibe coding" as purely chaotic development with no rules. I'm
### 1. Use `.gooseignore` to Protect Sensitive Files
Goose supports [`.gooseignore`](https://block.github.io/goose/docs/guides/using-gooseignore) files. The concept is similar to `.gitignore` files for your AI agent. It defines which files and folders Goose should *not* read, modify, or interact with.
Goose supports [`.gooseignore`](https://goose-docs.ai/docs/guides/using-gooseignore) files. The concept is similar to `.gitignore` files for your AI agent. It defines which files and folders Goose should *not* read, modify, or interact with.
Use this when you want to prevent:
@@ -59,13 +59,13 @@ Use this when you want to prevent:
### 2. Create a plan
Goose's [`/plan`](https://block.github.io/goose/docs/guides/goose-cli-commands#examples) command helps you align with your agent before any code is touched, giving you a clear understanding of what it intends to do and how it will do it.
Goose's [`/plan`](https://goose-docs.ai/docs/guides/goose-cli-commands#examples) command helps you align with your agent before any code is touched, giving you a clear understanding of what it intends to do and how it will do it.
This is especially useful for tasks that span multiple files, involve side effects, or could impact critical areas of your codebase. No more guesswork—just a structured breakdown you can review and approve.
### 3. Choose the Right Mode for the Job
While letting your AI agent take the lead is fun, not every moment calls for full autonomy. Sometimes, you need to pause, review, or plan before any code changes. Goose offers several [modes](https://block.github.io/goose/docs/guides/goose-permissions) that help you stay in control without breaking your momentum. Here's how to use them intentionally during your sessions:
While letting your AI agent take the lead is fun, not every moment calls for full autonomy. Sometimes, you need to pause, review, or plan before any code changes. Goose offers several [modes](https://goose-docs.ai/docs/guides/goose-permissions) that help you stay in control without breaking your momentum. Here's how to use them intentionally during your sessions:
* **Chat Mode**
Goose will only respond with text so that you can brainstorm together.
@@ -117,7 +117,7 @@ Before issues hit production, add [Goose to your CI/CD pipeline](/docs/tutorials
Some MCP servers can introduce security risks, especially if compromised.
Use the Goose [allowlist](https://github.com/block/goose/blob/main/crates/goose-server/ALLOWLIST.md) feature to prevent Goose from calling unsafe or untrusted tools.
Use the Goose [allowlist](https://github.com/aaif-goose/goose/blob/main/crates/goose-server/ALLOWLIST.md) feature to prevent Goose from calling unsafe or untrusted tools.
Here's how the team at Block is thinking about [securing the MCP](/blog/2025/03/31/securing-mcp).
@@ -128,7 +128,7 @@ Not all LLMs are built the same. Goose plays best with:
* Claude Sonnet 3.5
* GPT-4o
Lower-performing models might work, but they're more likely to hallucinate or misunderstand your goals. Read more about how [different LLM's perform with Goose](https://block.github.io/goose/blog/2025/03/31/goose-benchmark/).
Lower-performing models might work, but they're more likely to hallucinate or misunderstand your goals. Read more about how [different LLM's perform with Goose](https://goose-docs.ai/blog/2025/03/31/goose-benchmark/).
## Watch Vibe Coding in Action
Heres how folks vibe code with Goose:
@@ -139,17 +139,17 @@ Heres how folks vibe code with Goose:
Vibe coding isn't inherently wrong. It's marks a new chapter in how we build, and it opens the door for everyone. But experienced developers have a responsibility to define what smart, safe vibe coding looks like. Goose gives us the tools to set that standard, so the whole community can code creatively without sacrificing quality.
Download [Goose](https://block.github.io/goose/docs/getting-started/installation/), and start vibe coding with intention today!
Download [Goose](https://goose-docs.ai/docs/getting-started/installation/), and start vibe coding with intention today!
<head>
<meta property="og:title" content="How to Vibe Code Responsibly (with Goose)" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/04/08/vibe-code-responsibly" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/04/08/vibe-code-responsibly" />
<meta property="og:description" content="Vibe coding feels magical until it isn't. Learn how to flow with Goose while protecting your code, your team, and your future self." />
<meta property="og:image" content="http://block.github.io/goose/assets/images/responsible-vibe-code-a77f5e24a879edda943cc76f1fc0bd2a.png" />
<meta property="og:image" content="http://goose-docs.ai/assets/images/responsible-vibe-code-a77f5e24a879edda943cc76f1fc0bd2a.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="How to Vibe Code Responsibly (with Goose)" />
<meta name="twitter:description" content="Vibe coding feels magical until it isn't. Learn how to flow with Goose while protecting your code, your team, and your future self." />
<meta name="twitter:image" content="http://block.github.io/goose/assets/images/responsible-vibe-code-a77f5e24a879edda943cc76f1fc0bd2a.png" />
<meta name="twitter:image" content="http://goose-docs.ai/assets/images/responsible-vibe-code-a77f5e24a879edda943cc76f1fc0bd2a.png" />
</head>
@@ -82,12 +82,12 @@ And don't forget to [join the community](https://discord.gg/goose-oss) to see wh
<head>
<meta property="og:title" content="A Visual Guide To MCPs" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/04/10/visual-guide-mcp" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/04/10/visual-guide-mcp" />
<meta property="og:description" content="Visual breakdown of MCP: How your agent, tools, and models work together." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/mcpblog-40894789122bda594a8576ebcb67a2d8.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/mcpblog-40894789122bda594a8576ebcb67a2d8.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="A Visual Guide To MCPs" />
<meta name="twitter:description" content="Visual breakdown of MCP: How your AI agent, tools, and models work together." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/mcpblog-40894789122bda594a8576ebcb67a2d8.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/mcpblog-40894789122bda594a8576ebcb67a2d8.png" />
</head>
@@ -8,7 +8,7 @@ authors:
![blog cover](toolshim-header.png)
Our recently published [Goose benchmark](https://block.github.io/goose/blog/2025/03/31/goose-benchmark) revealed significant performance limitations in models where tool calling is not straightforwardly supported (e.g., Gemma3, Deepseek-r1, phi4). These models often fail to invoke tools at appropriate times or produce malformed or inconsistently formatted tool calls. With the most recent releases of Llama4 and Deepseek v3 (0324), we are again observing challenges with effective tool calling performance, even on these flagship openweight models.
Our recently published [Goose benchmark](https://goose-docs.ai/blog/2025/03/31/goose-benchmark) revealed significant performance limitations in models where tool calling is not straightforwardly supported (e.g., Gemma3, Deepseek-r1, phi4). These models often fail to invoke tools at appropriate times or produce malformed or inconsistently formatted tool calls. With the most recent releases of Llama4 and Deepseek v3 (0324), we are again observing challenges with effective tool calling performance, even on these flagship openweight models.
<!--truncate-->
@@ -18,13 +18,13 @@ Tool calling is a critical capability for agents like goose. It allows models to
## Background: using a local model as a "toolshim"
The goal is to allow goose to work with the widest variety of models possible. A "toolshim" in this case is a thin layer which sits between the main model doing the agent work, and the tools that can perform actual actions (making the agent take action, vs being a chatbot). Previously we have been trying this approach with open models including in this [past benchmark](https://block.github.io/goose/blog/2025/03/31/goose-benchmark) post. A toolshim, if it can work, unlocks both powerful cutting edge models (open weight and closed) which while may perform well on various benchmarks, fall well short when tool calling for agents is required (or perhaps don't, by design, support tool calling at all, such as the case with some reasoning models).
The goal is to allow goose to work with the widest variety of models possible. A "toolshim" in this case is a thin layer which sits between the main model doing the agent work, and the tools that can perform actual actions (making the agent take action, vs being a chatbot). Previously we have been trying this approach with open models including in this [past benchmark](https://goose-docs.ai/blog/2025/03/31/goose-benchmark) post. A toolshim, if it can work, unlocks both powerful cutting edge models (open weight and closed) which while may perform well on various benchmarks, fall well short when tool calling for agents is required (or perhaps don't, by design, support tool calling at all, such as the case with some reasoning models).
## Proposal: Fine-tune a lightweight toolshim model (up to 12b)
Develop a dedicated toolshim model that translates open-source model outputs into well-structured tool calls, acting as a reliable post-processor to standardize across model families trained that currently exhibit inconsistent and unreliable tool call generation behavior. We do not use tool calling apis even if available, but provide tool context in the system prompts.
We already experimented with this in the [benchmarking effort](https://block.github.io/goose/blog/2025/03/31/goose-benchmark), finding that phi4 (14b) and gemma3 (27b) achieved close performance to llama3.3 (70b) when used with a generic local model (mistral-nemo) as the shim. This shows potential for furthering their performance with more focused attention on improving the shim's performance.
We already experimented with this in the [benchmarking effort](https://goose-docs.ai/blog/2025/03/31/goose-benchmark), finding that phi4 (14b) and gemma3 (27b) achieved close performance to llama3.3 (70b) when used with a generic local model (mistral-nemo) as the shim. This shows potential for furthering their performance with more focused attention on improving the shim's performance.
Toolshim System Sketch:
@@ -86,12 +86,12 @@ On top of local models, we would like to consider parsers, parser combinators, c
<head>
<meta property="og:title" content="Finetuning Toolshim Models for Tool Calling" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/04/11/finetuning-toolshim" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/04/11/finetuning-toolshim" />
<meta property="og:description" content="Addressing performance limitations in models without native tool calling support" />
<meta property="og:image" content="https://block.github.io/goose/assets/images/toolshim-header-42611f614e7722f90cf83991debe3046.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/toolshim-header-42611f614e7722f90cf83991debe3046.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Finetuning Toolshim Models for Tool Calling" />
<meta name="twitter:description" content="Addressing performance limitations in models without native tool calling support" />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/toolshim-header-42611f614e7722f90cf83991debe3046.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/toolshim-header-42611f614e7722f90cf83991debe3046.png" />
</head>
@@ -27,17 +27,17 @@ Thank you so much for your contribution, ATrueLight4! Your work brings us one st
To show our deep gratitude for your contribution, we've granted you the exclusive ✨Top Contributor✨ badge on the Block Open Source Discord! You'll also be one of the first contributors to receive exclusive codename goose swag. (more info on that to be announced later 👀🪿)
## Get Your Own Spotlight
Interested in contributing to goose and having your contribution featured? Whether it's improving platform support, adding new features, or fixing bugs, we welcome all contributions from the open source community. You can [join the Block Open Source Discord](https://discord.gg/goose-oss) or [get started using codename goose](https://block.github.io/goose/) today.
Interested in contributing to goose and having your contribution featured? Whether it's improving platform support, adding new features, or fixing bugs, we welcome all contributions from the open source community. You can [join the Block Open Source Discord](https://discord.gg/goose-oss) or [get started using codename goose](https://goose-docs.ai/) today.
<head>
<meta property="og:title" content="How ATrueLight4 Helped Goose Navigate Windows" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/04/14/community-atruelight4" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/04/14/community-atruelight4" />
<meta property="og:description" content="Block Open Source Top Contributor of the Month" />
<meta property="og:image" content="https://block.github.io/goose/assets/images/goose4win-7f57433fa3f19849e74b18ebffe08bcf.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/goose4win-7f57433fa3f19849e74b18ebffe08bcf.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="How ATrueLight4 Helped Goose Navigate Windows" />
<meta name="twitter:description" content="Block Open Source Top Contributor of the Month" />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/goose4win-7f57433fa3f19849e74b18ebffe08bcf.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/goose4win-7f57433fa3f19849e74b18ebffe08bcf.png" />
</head>
@@ -104,12 +104,12 @@ Well see you in Atlanta 👀
<head>
<meta property="og:title" content="Codename Goose Goes to New York" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/04/17/goose-goes-to-NY" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/04/17/goose-goes-to-NY" />
<meta property="og:description" content="Goose lands in NYC for its second community meetup" />
<meta property="og:image" content="https://block.github.io/goose/assets/images/cover-6c131d275bcdb4d8651a140d62e2975f.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/cover-6c131d275bcdb4d8651a140d62e2975f.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Codename Goose Goes to New York" />
<meta name="twitter:description" content="Goose lands in NYC for its second community meetup" />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/cover-6c131d275bcdb4d8651a140d62e2975f.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/cover-6c131d275bcdb4d8651a140d62e2975f.png" />
</head>
@@ -125,12 +125,12 @@ We'd love to hear how others are approaching AI automation at scale.
<head>
<meta property="og:title" content="MCP in the Enterprise: Real World Adoption at Block" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose//blog/2025/04/21/mcp-in-enterprise" />
<meta property="og:url" content="https://goose-docs.ai//blog/2025/04/21/mcp-in-enterprise" />
<meta property="og:description" content="How Block is using MCP to power real world automation company-wide." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/mcp-for-enterprise-social-bb8a18872fedc0046ef72bb413dea851.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/mcp-for-enterprise-social-bb8a18872fedc0046ef72bb413dea851.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="MCP in the Enterprise: Real World Adoption at Block" />
<meta name="twitter:description" content="How Block is using MCP to power real world automation company-wide." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/mcp-for-enterprise-social-bb8a18872fedc0046ef72bb413dea851.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/mcp-for-enterprise-social-bb8a18872fedc0046ef72bb413dea851.png" />
</head>
@@ -270,12 +270,12 @@ Let goose surprise you. ✨
<head>
<meta property="og:title" content="11 Practical Ways I Use AI Agents Without Losing My Authenticity" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/04/21/practical-use-cases-of-ai" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/04/21/practical-use-cases-of-ai" />
<meta property="og:description" content="From conference planning to prepping podcasts, here's how I use AI Agents built on MCP for everyday tasks." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/mcp-use-cases-758ecc959d6334783257fc9d6329e1f2.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/mcp-use-cases-758ecc959d6334783257fc9d6329e1f2.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="11 Practical Ways I Use AI Agents Without Losing My Authenticity" />
<meta name="twitter:description" content="From conference planning to prepping podcasts, here's how I use AI Agents built on MCP for everyday tasks." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/mcp-use-cases-758ecc959d6334783257fc9d6329e1f2.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/mcp-use-cases-758ecc959d6334783257fc9d6329e1f2.png" />
</head>
@@ -13,30 +13,30 @@ The only way to discover how much of an impact your contributions can make is to
## How BestCodes Discovered Goose
[BestCodes](https://bestcodes.dev/) first discovered Goose during a [GitHub Open Source Friday livestream](https://www.youtube.com/watch?v=O-zJJN-TkXc&ab_channel=AngieJones) and decided to give it a try. At the time, Goose offered limited support for Windows/Linux (with more work in progress before any official release). Since BestCodes wasn't a Mac user, he wanted to help bring support to Linux. After lots of troubleshooting, he ended up creating [a Debian build fix](https://github.com/block/goose/pull/2070) that finally let him start using Goose on Linux.
[BestCodes (aka William Steele)](https://bestcodes.dev/) first discovered Goose during a [GitHub Open Source Friday livestream](https://www.youtube.com/watch?v=O-zJJN-TkXc&ab_channel=AngieJones) and decided to give it a try. At the time, Goose offered limited support for Windows/Linux (with more work in progress before any official release). Since BestCodes wasn't a Mac user, he wanted to help bring support to Linux. After lots of troubleshooting, he ended up creating [a Debian build fix](https://github.com/aaif-goose/goose/pull/2070) that finally let him start using Goose on Linux.
Even though BestCodes wondered if such a small fix was worth sharing, it was this "small" contribution that enabled fellow community members wanting to use Goose on Linux, and gave him momentum for future PRs. His experience is proof that your contribution has a chance to help someone, and you should share it! You never know what curiosity and the open source community can make happen.
## Building Momentum
BestCodes has continued to make Goose better with thoughtful improvements—from [polishing the UI](https://github.com/block/goose/pull/2079) and [refining load states](https://github.com/block/goose/pull/2079), to [fixing subtle bugs](https://github.com/block/goose/pull/2279) that make the Goose experience smoother for everyone. You can check out [BestCodes' contributions on GitHub](https://github.com/block/goose/pulls?q=is%3Apr+is%3Aclosed+author%3AThe-Best-Codes).
BestCodes has continued to make Goose better with thoughtful improvements—from [polishing the UI](https://github.com/aaif-goose/goose/pull/2079) and [refining load states](https://github.com/aaif-goose/goose/pull/2079), to [fixing subtle bugs](https://github.com/aaif-goose/goose/pull/2279) that make the Goose experience smoother for everyone. You can check out [BestCodes' contributions on GitHub](https://github.com/aaif-goose/goose/pulls?q=is%3Apr+is%3Aclosed+author%3AThe-Best-Codes).
Thank you so much for your continued support and contributions, BestCodes! Your work brings us one step closer to a full Goose experience on Windows and Linux.
To show how grateful we are for your contributions, we've granted you the exclusive ✨Top Contributor✨ badge on the Block Open Source Discord! Plus, you'll also be receiving exclusive codename goose swag. 👀🪿
## Become A Top Contributor
Interested in contributing to goose and having your work featured? Whether it's fixing bugs, sharing ideas, or helping others, every contribution from the open source community has the chance to help someone. You can [join the Block Open Source Discord](https://discord.gg/goose-oss) or [get started using codename goose](https://block.github.io/goose/) today.
Interested in contributing to goose and having your work featured? Whether it's fixing bugs, sharing ideas, or helping others, every contribution from the open source community has the chance to help someone. You can [join the Block Open Source Discord](https://discord.gg/goose-oss) or [get started using codename goose](https://goose-docs.ai/) today.
<head>
<meta property="og:title" content="How One Contribution Can Spark Many Wins" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/04/22/community-bestcodes" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/04/22/community-bestcodes" />
<meta property="og:description" content="The snowball effect of one contributor's fixes" />
<meta property="og:image" content="https://block.github.io/goose/assets/images/bestcodes-3d6c50de10a2d84def19d515aaea0724.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/bestcodes-3d6c50de10a2d84def19d515aaea0724.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="How One Contribution Can Spark Many Wins" />
<meta name="twitter:description" content="The snowball effect of one contributor's small fixes" />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/bestcodes-3d6c50de10a2d84def19d515aaea0724.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/bestcodes-3d6c50de10a2d84def19d515aaea0724.png" />
</head>
@@ -153,12 +153,12 @@ A: Your approach on this may vary depending on whether you're building your own
<head>
<meta property="og:title" content="MCP Is Rewriting the Rules of API Integration" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/04/22/mcp-is-rewriting-the-rules-of-api-integration" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/04/22/mcp-is-rewriting-the-rules-of-api-integration" />
<meta property="og:description" content="A developer's guide to modernizing API infrastructure with AI agents and Model Context Protocol. Learn about the benefits, integration strategies, and how to address security considerations." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/cover-1e2153c66f3f0c92da7bbaafd240a9b4.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/cover-1e2153c66f3f0c92da7bbaafd240a9b4.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="MCP Is Rewriting the Rules of API Integration" />
<meta name="twitter:description" content="A developer's guide to modernizing API infrastructure with AI agents and Model Context Protocol. Learn about the benefits, integration strategies, and how to address security considerations." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/cover-1e2153c66f3f0c92da7bbaafd240a9b4.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/cover-1e2153c66f3f0c92da7bbaafd240a9b4.png" />
</head>
@@ -43,9 +43,9 @@ Either way, Goose gives you the flexibility.
That said, if youre looking for the best performance with Goose right now, Anthropic's Claude 3.5 Sonnet and OpenAI's GPT-4o (2024-11-20) are recommended, as they currently offer the strongest support for tool calling.
Curious how other models stack up? Check out the [Community-Inspired Benchmark Leaderboard](https://block.github.io/goose/blog/2025/03/31/goose-benchmark/#leaderboard) to see how your favorite model performs with Goose.
Curious how other models stack up? Check out the [Community-Inspired Benchmark Leaderboard](https://goose-docs.ai/blog/2025/03/31/goose-benchmark/#leaderboard) to see how your favorite model performs with Goose.
And if youre still deciding, heres the full list of [available LLM providers](https://block.github.io/goose/docs/getting-started/providers#available-providers).
And if youre still deciding, heres the full list of [available LLM providers](https://goose-docs.ai/docs/getting-started/providers#available-providers).
---
@@ -65,7 +65,7 @@ Goose itself? Totally free and open source. 🎉 But your LLM provider might not
Most models give you a free tier to play around with, but if you're doing anything intensive or using it often, youll eventually run into rate limits or token charges. Thats normal but it can sneak up on you if youre not expecting it.
To help you manage this, there is a [Handling Rate Limits Guide](https://block.github.io/goose/docs/guides/handling-llm-rate-limits-with-goose/) that you can check out.
To help you manage this, there is a [Handling Rate Limits Guide](https://goose-docs.ai/docs/guides/handling-llm-rate-limits-with-goose/) that you can check out.
---
@@ -73,7 +73,7 @@ To help you manage this, there is a [Handling Rate Limits Guide](https://block.g
This part matters more than most people realize.
Goose has an entire community behind it—folks building, exploring, breaking things (and fixing them), and sharing everything they learn along the way. We hang out on [Discord](https://discord.gg/goose-oss), we answer questions in [GitHub Discussions](https://github.com/block/goose/discussions), and we host livestreams every week to show off what Goose can do and how to make it do more.
Goose has an entire community behind it—folks building, exploring, breaking things (and fixing them), and sharing everything they learn along the way. We hang out on [Discord](https://discord.gg/goose-oss), we answer questions in [GitHub Discussions](https://github.com/aaif-goose/goose/discussions), and we host livestreams every week to show off what Goose can do and how to make it do more.
Theres:
@@ -81,27 +81,27 @@ Theres:
- **Wild Goose Case** showcasing cool community projects
- **Great Goose Off** - same task, same time limit, but different prompts, MCP servers, and strategies
Youll find those livestreams on our [YouTube channel](https://www.youtube.com/@goose-oss/streams), and upcoming ones on the Discord calendar. Plus, if you prefer documentation, the [Goose docs](https://block.github.io/goose/) and [blog](https://block.github.io/goose/blog) are constantly being updated with new guides, tips, and tutorials.
Youll find those livestreams on our [YouTube channel](https://www.youtube.com/@goose-oss/streams), and upcoming ones on the Discord calendar. Plus, if you prefer documentation, the [Goose docs](https://goose-docs.ai/) and [blog](https://goose-docs.ai/blog) are constantly being updated with new guides, tips, and tutorials.
---
If you've got those four things: a performant LLM, the right MCP servers, a basic understanding of LLM cost, and a place to ask questions, you're more than ready to Goose.
Now, head over to the [Quickstart Guide](https://block.github.io/goose/docs/quickstart) and get started.
Now, head over to the [Quickstart Guide](https://goose-docs.ai/docs/quickstart) and get started.
Oh and when you get to the [Tic-Tac-Toe game](https://block.github.io/goose/docs/quickstart/#write-prompt), Ill bet you 10 Goosebucks you wont beat the bot.
Oh and when you get to the [Tic-Tac-Toe game](https://goose-docs.ai/docs/quickstart/#write-prompt), Ill bet you 10 Goosebucks you wont beat the bot.
<head>
<meta property="og:title" content="4 Things You Need to Know Before Using Goose" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/04/23/things-need-to-know" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/04/23/things-need-to-know" />
<meta property="og:description" content="Learn what you need to get started with Goose - a local open source AI agent that's powered by the LLM of your choice." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/cover-2ba7c2e15786be2db6108c91d27dc1ec.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/cover-2ba7c2e15786be2db6108c91d27dc1ec.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="4 Things You Need to Know Before Using Goose" />
<meta name="twitter:description" content="Learn what you need to get started with Goose - a local open source AI agent that's powered by the LLM of your choice." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/cover-2ba7c2e15786be2db6108c91d27dc1ec.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/cover-2ba7c2e15786be2db6108c91d27dc1ec.png" />
</head>
@@ -195,12 +195,12 @@ Your team is full of problem solvers. One teammate built a slick internal dashbo
<head>
<meta property="og:title" content="A Recipe for Success: Cooking Up Repeatable Agentic Workflows" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/05/06/recipe-for-success" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/05/06/recipe-for-success" />
<meta property="og:description" content="A fresh look at AI agents, orchestration, and repeatability told through the metaphor of a rat who can cook." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/cookingwithgoose-9114cf03cec76df4792fc58361ebe20b.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/cookingwithgoose-9114cf03cec76df4792fc58361ebe20b.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="A Recipe for Success: Cooking Up Repeatable Agentic Workflows" />
<meta name="twitter:description" content="A fresh look at AI agents, orchestration, and repeatability told through the metaphor of a rat who can cook." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/cookingwithgoose-9114cf03cec76df4792fc58361ebe20b.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/cookingwithgoose-9114cf03cec76df4792fc58361ebe20b.png" />
</head>
@@ -300,13 +300,13 @@ We'd love for you to share your ideas with us! Share your ideas by creating a re
<head>
<meta property="og:title" content="Championship Driven Development: Your team's AI Playbook for Peak Performance" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/05/09/developers-ai-playbook-for-team-efficiency" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/05/09/developers-ai-playbook-for-team-efficiency" />
<meta property="og:description" content="Learn how AI-driven 'plays,' based on Model Context Protocol, can help development teams improve common workflows like changelog generation and pull requests." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/cdd-playbook-69a053588574d8678c2acb92a1b21da6.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/cdd-playbook-69a053588574d8678c2acb92a1b21da6.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Championship Driven Development: Your team's AI Playbook for Peak Performance" />
<meta name="twitter:description" content="Learn how AI-driven 'plays,' based on Model Context Protocol, can help development teams improve common workflows like changelog generation and pull requests." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/cdd-playbook-69a053588574d8678c2acb92a1b21da6.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/cdd-playbook-69a053588574d8678c2acb92a1b21da6.png" />
<meta name="keywords" content="AI development; Model Context Protocol; developer productivity; team playbook; AI automation; Goose; software development efficiency; changelogs; pull requests" />
</head>
@@ -60,13 +60,13 @@ It would be interesting to try the larger models if, you have access to hardware
<head>
<meta property="og:title" content="Goose and Qwen3 for Local Execution" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/05/12/local-goose-qwen3" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/05/12/local-goose-qwen3" />
<meta property="og:description" content="Run AI commands locally with Goose and Qwen3 for fast, offline tool execution" />
<meta property="og:image" content="https://block.github.io/goose/assets/images/goose-qwen-local-62d07cd240ff65cb99a6ef41a2c851a5.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/goose-qwen-local-62d07cd240ff65cb99a6ef41a2c851a5.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Goose and Qwen3 for Local Execution" />
<meta name="twitter:description" content="Run AI commands locally with Goose and Qwen3 for fast, offline tool execution" />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/goose-qwen-local-62d07cd240ff65cb99a6ef41a2c851a5.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/goose-qwen-local-62d07cd240ff65cb99a6ef41a2c851a5.png" />
</head>
@@ -149,12 +149,12 @@ We're always excited to see what the community is up to. If you're working on yo
<head>
<meta property="og:title" content="Goose Gets a Driver's License!" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/05/06/goose-gets-a-drivers-license" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/05/06/goose-gets-a-drivers-license" />
<meta property="og:description" content="Control a MakeBlock mbot2 rover through MQTT and MCP as a Goose Extension" />
<meta property="og:image" content="https://block.github.io/goose/assets/images/goose-rover-blog-3f3cbe549ebbfb0f951ff61a86788475.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/goose-rover-blog-3f3cbe549ebbfb0f951ff61a86788475.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Goose Gets a Driver's License!" />
<meta name="twitter:description" content="Control a MakeBlock mbot2 rover through MQTT and MCP as a Goose Extension" />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/goose-rover-blog-3f3cbe549ebbfb0f951ff61a86788475.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/goose-rover-blog-3f3cbe549ebbfb0f951ff61a86788475.png" />
</head>
@@ -97,12 +97,12 @@ If a model passes this multi-turn prompt sequence, it's safe to assume that it i
<head>
<meta property="og:title" content="3 Prompts to Test for Agent Readiness" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/05/22/llm-agent-readiness" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/05/22/llm-agent-readiness" />
<meta property="og:description" content="A series of prompts to test an LLM's capabilities to be used with AI agents" />
<meta property="og:image" content="https://block.github.io/goose/assets/images/llm-agent-test-86ce2379ce4dde48ae1448f0f9d75c1f.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/llm-agent-test-86ce2379ce4dde48ae1448f0f9d75c1f.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="3 Prompts to Test for Agent Readiness" />
<meta name="twitter:description" content="A series of prompts to test an LLM's capabilities to be used with AI agents" />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/llm-agent-test-86ce2379ce4dde48ae1448f0f9d75c1f.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/llm-agent-test-86ce2379ce4dde48ae1448f0f9d75c1f.png" />
</head>
@@ -88,12 +88,12 @@ Freeing up ports is something I know how to do. But I use AI tools like Goose fo
<head>
<meta property="og:title" content="How I Manage Localhost Port Conflicts With an AI Agent" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/05/22/manage-local-host-conflicts-with-goose" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/05/22/manage-local-host-conflicts-with-goose" />
<meta property="og:description" content="Learn how I use Goose, an open source AI agent, to manage conflicting ports without breaking my flow." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/hoarders-753809f09399a9e4f734006a8d74218d.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/hoarders-753809f09399a9e4f734006a8d74218d.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="How I Manage Localhost Port Conflicts With an AI Agent" />
<meta name="twitter:description" content="Learn how I use Goose, an open source AI agent, to manage conflicting ports without breaking my flow." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/hoarders-753809f09399a9e4f734006a8d74218d.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/hoarders-753809f09399a9e4f734006a8d74218d.png" />
</head>
@@ -431,12 +431,12 @@ Block is dedicated to improving its security defenses and supporting its team by
<head>
<meta property="og:title" content="Democratizing Detection Engineering at Block: Taking Flight with Goose and Panther MCP" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/06/02/goose-panther-mcp" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/06/02/goose-panther-mcp" />
<meta property="og:description" content="A comprehensive overview of how Block leverages Goose and Panther MCP to democratize and accelerate security detection engineering." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/goose-panther-header-25b5891acdd70e6a7bbe6b84e34f08f0.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/goose-panther-header-25b5891acdd70e6a7bbe6b84e34f08f0.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Democratizing Detection Engineering at Block: Taking Flight with Goose and Panther MCP" />
<meta name="twitter:description" content="A comprehensive overview of how Block leverages Goose and Panther MCP to democratize and accelerate security detection engineering." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/goose-panther-header-25b5891acdd70e6a7bbe6b84e34f08f0.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/goose-panther-header-25b5891acdd70e6a7bbe6b84e34f08f0.png" />
</head>
@@ -124,13 +124,13 @@ Share your own `.goosehints` optimization stories in the [Goose community on Dis
<head>
<meta property="og:title" content="What's in my .goosehints file (and why it probably shouldn't be)" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/06/05/whats-in-my-goosehints-file" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/06/05/whats-in-my-goosehints-file" />
<meta property="og:description" content="Learn how to optimize your Goose configuration by understanding when to use .goosehints vs Memory Extension for better performance and maintainability." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/blog-banner-7f0e5ed1cf875e64e3ebb3250932baaf.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/blog-banner-7f0e5ed1cf875e64e3ebb3250932baaf.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="What's in my .goosehints file (and why it probably shouldn't be)" />
<meta name="twitter:description" content="Learn how to optimize your Goose configuration by understanding when to use .goosehints vs Memory Extension for better performance and maintainability." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/blog-banner-7f0e5ed1cf875e64e3ebb3250932baaf.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/blog-banner-7f0e5ed1cf875e64e3ebb3250932baaf.png" />
<meta name="keywords" content="Goose; .goosehints; Memory Extension MCP; AI configuration; performance optimization; developer productivity; context management; AI assistant; token costs; LLM efficiency" />
</head>
@@ -89,12 +89,12 @@ If you're experimenting with multi-model setups, [share what's working and what
<head>
<meta property="og:title" content="Treating LLMs Like Tools in a Toolbox: A Multi-Model Approach to Smarter AI Agents" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/06/16/multi-model-in-goose" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/06/16/multi-model-in-goose" />
<meta property="og:description" content="How Goose uses multiple LLMs within a single task, optimizing for speed, cost, and reliability in AI agent workflows" />
<meta property="og:image" content="https://block.github.io/goose/assets/images/multi-model-ai-agent-d408feaeba3e13cafdbfe9377980bc3d.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/multi-model-ai-agent-d408feaeba3e13cafdbfe9377980bc3d.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Treating LLMs Like Tools in a Toolbox: A Multi-Model Approach to Smarter AI Agents" />
<meta name="twitter:description" content="How Goose uses multiple LLMs within a single task, optimizing for speed, cost, and reliability in AI agent workflows" />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/multi-model-ai-agent-d408feaeba3e13cafdbfe9377980bc3d.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/multi-model-ai-agent-d408feaeba3e13cafdbfe9377980bc3d.png" />
</head>
@@ -97,12 +97,12 @@ Happy experimenting!
<head>
<meta property="og:title" content="Why I Used Goose to Build a Chaotic Emotion Detection App" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/06/17/goose-emotion-detection-app" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/06/17/goose-emotion-detection-app" />
<meta property="og:description" content="The joys of experimenting with computer vision using Goose, an MCP host" />
<meta property="og:image" content="https://block.github.io/goose/assets/images/emotion-powered-ui-83b0e779f22a3a060eef7bb29e04090d.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/emotion-powered-ui-83b0e779f22a3a060eef7bb29e04090d.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Why I Used Goose to Build a Chaotic Emotion Detection App" />
<meta name="twitter:description" content="The joys of experimenting with computer vision using Goose, an MCP host" />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/emotion-powered-ui-83b0e779f22a3a060eef7bb29e04090d.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/emotion-powered-ui-83b0e779f22a3a060eef7bb29e04090d.png" />
</head>
@@ -102,7 +102,7 @@ extensions:
---
*Questions? Join our [GitHub discussions](https://github.com/block/goose) or [Discord](https://discord.gg/goose-oss). Learn more about Dagger at [dagger.io](https://dagger.io/).*
*Questions? Join our [GitHub discussions](https://github.com/aaif-goose/goose) or [Discord](https://discord.gg/goose-oss). Learn more about Dagger at [dagger.io](https://dagger.io/).*
{/* Video Player */}
<div style={{ width: '100%', maxWidth: '800px', margin: '0 auto' }}>
@@ -121,12 +121,12 @@ extensions:
<head>
<meta property="og:title" content="Isolated Dev Environments in Goose with container-use" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/06/19/isolated-development-environments" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/06/19/isolated-development-environments" />
<meta property="og:description" content="Never worry about breaking your development setup again with containerized, git-branch-isolated development environments powered by container-use" />
<meta property="og:image" content="https://block.github.io/goose/assets/images/sandbox-0b0f5e6f871cbf48ea1a0be243440aa1.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/sandbox-0b0f5e6f871cbf48ea1a0be243440aa1.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Isolated Dev Environments in Goose with container-use" />
<meta name="twitter:description" content="Never worry about breaking your development setup again with containerized, git-branch-isolated development environments powered by container-use" />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/sandbox-0b0f5e6f871cbf48ea1a0be243440aa1.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/sandbox-0b0f5e6f871cbf48ea1a0be243440aa1.png" />
</head>
@@ -114,12 +114,12 @@ What everyday tasks are you delegating to AI agents? Let us know in [Discord](ht
<head>
<meta property="og:title" content="5 Boring Tasks I Gave to My AI Agent Today (That Saved Me Hours)" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/06/27/everyday-usecases-ai" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/06/27/everyday-usecases-ai" />
<meta property="og:description" content="Forget the flashy demos. Here's everyday use cases for AI." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/everyday-usage-of-ai-69f4444328b28bdc945e5ff9fc92034d.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/everyday-usage-of-ai-69f4444328b28bdc945e5ff9fc92034d.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="5 Boring Tasks I Gave to My AI Agent Today (That Saved Me Hours)" />
<meta name="twitter:description" content="Forget the flashy demos. Here's everyday use cases for AI." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/everyday-usage-of-ai-69f4444328b28bdc945e5ff9fc92034d.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/everyday-usage-of-ai-69f4444328b28bdc945e5ff9fc92034d.png" />
</head>
@@ -176,12 +176,12 @@ What will you build with subagents?
<head>
<meta property="og:title" content="Orchestrating 6 Subagents to Build a Collaborative API Playground for Kids" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/07/21/orchestrating-subagents" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/07/21/orchestrating-subagents" />
<meta property="og:description" content="Delegating backend, frontend, docs, and tests so six subagents could build collaborative API tool for kids." />
<meta property="og:image" content="https://block.github.io/goose/assets/images/built-by-subagents-869a01d4b147ebdb54334dcc22dc521e.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/built-by-subagents-869a01d4b147ebdb54334dcc22dc521e.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Orchestrating 6 Subagents to Build a Collaborative API Playground for Kids" />
<meta name="twitter:description" content="Delegating backend, frontend, docs, and tests so six subagents could build collaborative API tool for kids." />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/built-by-subagents-869a01d4b147ebdb54334dcc22dc521e.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/built-by-subagents-869a01d4b147ebdb54334dcc22dc521e.png" />
</head>
@@ -437,12 +437,12 @@ You caught me being an impolite AI! Even artificial beings should have better ma
<head>
<meta property="og:title" content="When AI Meets AI: Goose Desktop and CLI Collaborate" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/07/28/ai-to-ai" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/07/28/ai-to-ai" />
<meta property="og:description" content="I told Goose Desktop to go have a conversation with Goose CLI and what happened next was fascinating!" />
<meta property="og:image" content="https://block.github.io/goose/assets/images/ai-to-ai-dc88f565e573f0825a4fde3c522d2b8b.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/ai-to-ai-dc88f565e573f0825a4fde3c522d2b8b.png" />
<meta name="twitter:card" content="summary_large_image" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="When AI Meets AI: Goose Desktop and CLI Collaborate" />
<meta name="twitter:description" content="I told Goose Desktop to go have a conversation with Goose CLI and what happened next was fascinating!" />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/ai-to-ai-dc88f565e573f0825a4fde3c522d2b8b.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/ai-to-ai-dc88f565e573f0825a4fde3c522d2b8b.png" />
</head>
@@ -9,7 +9,7 @@ authors:
Creating effective security detections in Panther traditionally requires deep knowledge of detection logic, testing frameworks, and development workflows. The detection engineering team at Block has streamlined this process by building Goose recipes that automate the entire detection creation lifecycle from initial repository set up to pull request creation.
This blog post explores how to leverage Goose's [recipe](https://block.github.io/goose/docs/guides/recipes/) and [subrecipe](https://block.github.io/goose/docs/guides/recipes/subrecipes) system to create new detections in Panther with minimal manual intervention, ensuring consistency, quality, and adherence to team standards.
This blog post explores how to leverage Goose's [recipe](https://goose-docs.ai/docs/guides/recipes/) and [subrecipe](https://goose-docs.ai/docs/guides/recipes/subrecipes) system to create new detections in Panther with minimal manual intervention, ensuring consistency, quality, and adherence to team standards.
<!-- truncate -->
@@ -70,7 +70,7 @@ The detection creation recipe demonstrates the power of this approach by coordin
6. [**pr_creator**](#6-pr_creator-automated-pull-request-pipeline) - Pull request creation with proper formatting
### What about .goosehints?
In our [previous post](https://block.github.io/goose/blog/2025/06/02/goose-panther-mcp), we discussed using [.goosehints](/docs/guides/context-engineering/using-goosehints/) to provide persistent context to the Large Language Model (LLM). We continue to use `.goosehints` to define coding standards and universal preferences that guide LLM behavior.
In our [previous post](https://goose-docs.ai/blog/2025/06/02/goose-panther-mcp), we discussed using [.goosehints](/docs/guides/context-engineering/using-goosehints/) to provide persistent context to the Large Language Model (LLM). We continue to use `.goosehints` to define coding standards and universal preferences that guide LLM behavior.
However, to minimize redundancy and avoid conflicting guidance, we adopted a single reference file, `AGENTS.md`, as the source of truth for all agents. Each agent is directed to consult this file, while still supporting agent-specific instructions through their default context files (e.g. `.goosehints`, `CLAUDE.md` etc.) or rules (e.g. `.cursor/rules/`).
@@ -622,13 +622,13 @@ Whether you're building your first Goose recipe or looking to optimize existing
<head>
<meta property="og:title" content="Streamlining Detection Development with Goose Recipes" />
<meta property="og:type" content="article" />
<meta property="og:url" content="https://block.github.io/goose/blog/2025/07/28/streamlining-detection-development-with-goose-recipes" />
<meta property="og:url" content="https://goose-docs.ai/blog/2025/07/28/streamlining-detection-development-with-goose-recipes" />
<meta property="og:description" content="A comprehensive guide to using recipes in Goose to streamline security detection development" />
<meta property="og:image" content="https://block.github.io/goose/assets/images/goose-recipes-detection-development-cover.png" />
<meta property="og:image" content="https://block.github.io/goose/assets/images/goose-recipes-detection-development-cover-cac8a9bea2d090ec2758a0b907bc9da8.png" />
<meta property="twitter:domain" content="block.github.io/goose" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/goose-recipes-detection-development-cover.png" />
<meta property="og:image" content="https://goose-docs.ai/assets/images/goose-recipes-detection-development-cover-cac8a9bea2d090ec2758a0b907bc9da8.png" />
<meta property="twitter:domain" content="goose-docs.ai" />
<meta name="twitter:title" content="Streamlining Detection Development with Goose Recipes" />
<meta name="twitter:description" content="A comprehensive guide to using recipes in Goose to streamline security detection development" />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/goose-recipes-detection-development-cover.png" />
<meta name="twitter:image" content="https://block.github.io/goose/assets/images/goose-recipes-detection-development-cover-cac8a9bea2d090ec2758a0b907bc9da8.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/goose-recipes-detection-development-cover.png" />
<meta name="twitter:image" content="https://goose-docs.ai/assets/images/goose-recipes-detection-development-cover-cac8a9bea2d090ec2758a0b907bc9da8.png" />
</head>

Some files were not shown because too many files have changed in this diff Show More