Get started with Goose

Goose is a free, open-source AI agent that runs on your machine — so it can actually create files and run code, which a web app can’t. The Build Studio exports a Goose recipe that configures it with your project’s constitution, vetted stack, and intent.

Bring a permitted provider

Configure Goose with a permitted, bring-your-own-key model provider — Anthropic, DeepSeek, Kimi, OpenRouter, or local Ollama. Do not use OpenAI or xAI; that would break the very policy you’re building under.

1. Install Goose

macOS / Linux

curl -fsSL https://block.github.io/goose/install.sh | bash

Windows

Use WSL, then run the macOS/Linux command above. (See the official docs for the latest installer.)

2. Configure a permitted provider (BYOK)

1. Get an API key from a permitted provider (e.g. an Anthropic, DeepSeek, or OpenRouter account). You pay the provider directly — your key stays on your machine.
2. Run the configurator and pick that provider:

   goose configure

   Choose Anthropic / OpenRouter / DeepSeek / Ollama — not OpenAI or xAI.

3. Run your project’s recipe

1. In the Build Studio, pick Run with Goose on the Generate step and Download Goose recipe (a .goose-recipe.yaml).
2. From your project folder, run:

   goose run --recipe my-app.goose-recipe.yaml

3. Goose reads the recipe’s constitution and intent, uses only the vetted stack, and starts building. Keep every change clean:

   npx tsx ./enforcement/cli.ts all --tree .

Prefer not to install anything?

You can also Download .zip (open it with any agent), use Create GitHub repo for a one-click remote start, or Kickoff with AI (BYOK) to generate a plan from the browser. The Studio lets you choose.