Skip to main content
goose is Block’s open-source terminal agent. It runs shell commands and edits files through its built-in developer extension.

Install

Configure

Supply the key through the environment:
goose splits the endpoint into OPENAI_HOST (scheme and host) and OPENAI_BASE_PATH (the full path including /chat/completions). This is unlike every other client on these pages, which take one base URL.

One-shot runs

goose can search the web through Lyceum, with no search key of your own. Its built-in OpenAI provider can’t add request fields, so add Lyceum as a custom provider and turn search on for each model. Save this as ~/.config/goose/custom_providers/lyceum.json:
~/.config/goose/custom_providers/lyceum.json
Then set GOOSE_PROVIDER: lyceum and GOOSE_MODEL: z-ai/glm-5.3 in config.yaml, and export your key as LYCEUM_API_KEY. The model searches when a question needs current information and cites its sources in the answer. request_params apply to one model, so add an entry for each model you use. See Web search for options and pricing. Without this, goose searches with its built-in web search skill, which runs on your machine. goose leans on tool calling heavily. moonshotai/kimi-k2.7-code and z-ai/glm-5.2 both handle its shell-and-edit loop well.