Downsizing logodownsizing
Documentation

Using Downsizing with Goose

Route Goose (Block's open-source AI agent CLI) traffic through Downsizing in seconds using the CLI.


Prerequisites

Before linking Goose, connect an Anthropic API key at console.anthropic.com/settings/keys so Downsizing can route on your behalf. We also recommend using the CLI — check the CLI guide to install it, and Goose's installation guide if you don't have Goose installed yet.

Link Goose (Recommended)

With Downsizing connected, link Goose to route traffic through Downsizing:

bash
ds link goose

The CLI configures Goose's built-in Anthropic provider to point at your Downsizing endpoint, and writes your Downsizing API key to Goose's file-based secret store so no interactive keyring prompt is required.

Manual Setup

If you prefer to configure manually, edit ~/.config/goose/config.yaml and add:

yaml
GOOSE_PROVIDER: "anthropic"
GOOSE_MODEL: "claude-opus-4-8"
ANTHROPIC_HOST: "https://api.downsizing.dev/YOUR_INFERENCE_ID/anthropic"
GOOSE_DISABLE_KEYRING: true

GOOSE_DISABLE_KEYRINGtells Goose to store secrets in a plain file instead of the OS keyring — required since Goose's Anthropic provider never reads an API key from config.yaml. With it set, add your key to ~/.config/goose/secrets.yaml:

yaml
ANTHROPIC_API_KEY: "dws_YOUR_API_KEY"

Find your Inference ID and API key on the Inference API page.

Verify

Run a quick one-shot prompt to confirm traffic is routing through Downsizing:

bash
goose run -t "hello"

If Goose responds, Downsizing is set up correctly. You can also check your savings dashboard to see the request appear in your usage metrics.

Unlinking

To remove Downsizing from Goose and restore your original settings:

bash
ds unlink goose

Spot an error or something not working? Tell us on Discord or email docs@downsizing.dev.