Goose

Goose

An open-source AI agent for your terminal and desktop that runs on any OpenAI-compatible model.

What Goose is

Goose is an open-source AI agent from Block that runs in your terminal or as a desktop app. It can write, run, edit and test code on your own machine using any LLM. By pointing its OpenAI provider at TokenMix, you can drive Goose with Claude, GPT, DeepSeek and more. This guide covers the CLI; the desktop app uses the same settings.

Before you start

Connect TokenMix

Goose splits the endpoint into a host and a base path. This is the step people get wrong: the host does not include /v1. The /v1/chat/completions part is the base path, which already defaults to the right value.

  1. In your terminal, run: goose configure
  2. Choose "Configure Providers", then select "OpenAI".
  3. OPENAI_API_KEY: paste your sk-tm- key.
  4. OPENAI_HOST: enter https://api.tokenmix.ai with no /v1 at the end.
  5. OPENAI_BASE_PATH: press Enter to keep the default v1/chat/completions.
  6. Enter the model you want to use, for example claude-sonnet-4.6.

Check it works

Start a session with: goose session

Ask it something simple like "what files are in this folder?". A sensible answer means Goose is connected to TokenMix. You can confirm the spend in the TokenMix Console.

Common questions

Connection errors: make sure OPENAI_HOST is exactly https://api.tokenmix.ai with no /v1, and that OPENAI_BASE_PATH stayed as v1/chat/completions. Putting /v1 in the host is the most common mistake.

Desktop app: open Settings, go to Models, configure the OpenAI provider, and set the same host and key.

Which models to pick: for agent and coding work, Claude Opus 4.8, Claude Sonnet 4.6 and DeepSeek V4 Pro are solid choices.