> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aireserve.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Goose

> Point Block's Goose agent at the AI Reserve gateway — Anthropic dialect at the host root, OpenAI dialect with goose's own base path.

<Card title="Create your API key →" icon="key" href="https://portal.aireserve.com/profile#api-keys" horizontal>
  Mint an `aireserve_api_…` key in the portal — every Goose session is then
  metered and billed through your organization.
</Card>

Goose configures providers in `~/.config/goose/config.yaml`
([provider reference](https://block.github.io/goose/docs/getting-started/providers)).
For Claude models, use the `anthropic` provider pointed at the gateway's host
root:

```yaml theme={"dark"}
GOOSE_PROVIDER: anthropic
GOOSE_MODEL: claude-sonnet-4-6
ANTHROPIC_HOST: https://api.aireserve.com   # host root — goose appends /v1/messages
keyring: false
```

```bash theme={"dark"}
export ANTHROPIC_API_KEY="$AIRESERVE_API_KEY"   # your aireserve_api_… key
goose run -t "your prompt"                      # or `goose` for the interactive session
```

For GPT models (or any gateway model over the OpenAI dialect), swap the
provider block:

```yaml theme={"dark"}
GOOSE_PROVIDER: openai
GOOSE_MODEL: gpt-5.4-mini
OPENAI_HOST: https://api.aireserve.com   # host root — NO /v1
keyring: false
```

```bash theme={"dark"}
export OPENAI_API_KEY="$AIRESERVE_API_KEY"
goose run -t "your prompt"
```

<Note>
  **Goose hosts are roots, not `/v1` URLs.** Unlike most OpenAI-flavored
  tools, goose builds the path itself: `OPENAI_HOST` gets
  `v1/chat/completions` appended (via its `OPENAI_BASE_PATH` default) and
  `ANTHROPIC_HOST` gets `/v1/messages`. If you see a 404, the usual cause is
  a `/v1` already on the host doubling the path. Keys never go in
  `config.yaml` — goose ignores them there; use the environment variable (or
  goose's keyring/`secrets.yaml`).
</Note>

## Verify

Run the one-shot command above. Goose answers in the terminal, and the
request appears on your
[usage page](https://portal.aireserve.com/profile) — metered against your
key, tool calls included.