Goose CLI Cheatsheet - Block / Linux Foundation AAIF Agent Full Reference

All Goose general-purpose AI agent commands in one place — from interactive sessions to one-shot runs, extension management, and diagnostics — organized by scenario. Copy and go.

AI CLI·30 commands·Last updated 2026-08-21

Session & Run 5

goose session
Start an interactive session (default)
goose session --name feat/login
Name a session for later resume
goose session --resume
Resume the previous session
goose run "Refactor the utils module"
One-shot non-interactive task
goose run --stdin
Read the task from stdin

Configure & Auth 5

goose configure
Interactive provider/key setup
goose configure extensions
Configure extension connections
export GOOSE_PROVIDER=anthropic
Set the provider env var
export GOOSE_MODEL=claude-sonnet
Set the default model
export ANTHROPIC_API_KEY=sk-ant-...
Set the model API key

Extensions (MCP) 5

goose extensions list
List installed extensions
goose extensions add <name>
Add an extension
goose extensions remove <name>
Remove an extension
goose session -e <ext>
Enable an extension for this session
goose configure extensions
Interactive extension config

Recipes & Diagnostics 5

goose cook recipe.yaml
Run a multi-step workflow from a recipe
goose doctor
Diagnose environment/config issues
goose logs
View run logs
goose update
Upgrade Goose to the latest
goose completion bash
Generate shell completion

Serve & Debug 5

goose server start
Start the Goose server
goose server stop
Stop the server
goose server status
Check server status
goose sessions list
List historical sessions
goose chat
Jump straight into chat mode

Global Flags 5

goose run -v "task"
Verbose logging (--verbose)
goose session --session-id <id>
Specify a session ID
goose run --profile prod
Run with a named profile
goose configure --help
Show configure subcommand help
goose --version
Print the version

Tips

  • Goose now sits under Linux Foundation AAIF — Rust + Apache-2.0, 15+ providers and 70+ MCP extensions; rising enterprise adoption makes it a strong "general desktop agent" pick.
  • Encode recurring flows as recipe.yaml and run with `goose cook` — more reproducible than retyping prompts, and easy to share with a team.
  • Set provider/model via env vars (GOOSE_PROVIDER/GOOSE_MODEL) or profiles to switch prod/dev without changing commands.
  • On environment issues run `goose doctor` then `goose logs` — most config/extension problems self-diagnose.

Official References

Commands are compiled from the official docs below. Click to verify the latest usage.

Maintained by LaoHand

Publicly updated on Aug 21, 2026, continuously proofread against official docs.

Contact Us

Wrong command or description? Send us corrections, business inquiries or product feedback by email.

Contact Us