goose
goose is a local AI agent and CLI tool for automating engineering tasks. It's completely open-source with no vendor lock-in, supports local LLMs, has extensive MCP (Model Context Protocol) support, and offers powerful extensibility through recipes.
Prerequisites
In order to use the AI Gateway with goose you will need to complete these steps first:
-
Create a new provider in the AI Gateway for the provider you want to use with goose
-
Create a new app to use specifically with goose and assign it to the team you created
-
Copy the API URL and API Key shown at the top of the app page
Configure goose
Because goose can be run as a standalone desktop app and a CLI there are two configuration approaches depending on which version you choose.
CLI
-
Run
goose configure -
Select Configure Providers from the menu
-
Choose OpenAI as the provider you want to add (this will work for any OpenAI compatible provider and model)
-
Set the
OPENAI_API_KEYto the API Key for the app you created for goose in Zuplo -
Set the
OPENAI_HOSTto your app's gateway URL without the/v1suffix (for examplehttps://my-gateway-main-2e18f50.zuplo.app/config_fe0a04972d2848e0a94ae4b8bcd1497e)—the base path in the next step supplies it -
The
OPENAI_BASE_PATHmay already be configured. If it's not, enterv1/chat/completionsas the value -
Enter the model you want to use with goose, as
providerName/model—for exampleopenai/gpt-5-mini.
The app's Model Filtering policy controls which models the app may use, so the model you enter here must be one that policy allows.
After completing the steps, goose will check the configuration. If all is well it will save the configuration and you are ready to start working with goose via the AI Gateway.
Desktop App
If you are using the goose desktop app you can add a Custom Provider for AI Gateway by following these steps:
-
Open the goose desktop app
-
Click on Settings
-
Click on Configure Providers to open the Provider settings
-
Click on Add Custom Provider
-
Choose a Provider Type (both OpenAI Compatible and Anthropic compatible will work)
-
Enter a Display Name (for example Zuplo AI Gateway)
-
Set the API URL to your app's gateway URL
-
Set the API Key to the API key of the app you created for goose in Zuplo
-
Set the list of Available Models to the models the app's Model Filtering policy allows, named as
providerName/model(for exampleopenai/gpt-5-mini,openai/gpt-5,openai/gpt-5-nano) -
Click on Create Provider
The Zuplo AI Gateway and associated provider and models will now be available to use with the goose desktop app.