Skip to main content

Goose

Install, authenticate, and resume Block's Goose inside Daintree, including the session subcommand, provider env vars, and the macOS config path.

Updated
Reviewed

Goose

Goose is Block's provider-agnostic coding agent. It runs as a process in its own Daintree terminal panel with full PTY emulation, like every other built-in agent.

Commandgoose session
Shortcut
ColorCharcoal (#1c1c1c)
PlatformsmacOS, Windows, Linux

Install & Authenticate

brew install block-goose-cli
# or
curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash

Once it's installed, run goose configure to pick a provider and supply credentials. Daintree launches Goose with the session subcommand, so the effective command is goose session. Provider env vars (GOOSE_PROVIDER, GOOSE_MODEL, ANTHROPIC_API_KEY, OPENAI_API_KEY, GOOGLE_API_KEY) take precedence over the on-disk config.

Note
On macOS, Goose stores its config at ~/Library/Application Support/Block/goose/config.yaml, not ~/.config. That's where to look if you need to edit it by hand.

Resuming Sessions

Daintree captures Goose's session ID on shutdown and resumes with goose session --resume --session-id <id>. Quit a session cleanly with /exit so the ID is captured. For the resume mechanics across all agents, see Session Resume.

Tip
If goose isn't detected after install, confirm it's on your PATH (which goose on macOS/Linux, where goose on Windows), then restart Daintree. See Agent Availability for the five detection states, and Presets for launch configuration.