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.
Session & Run 5
goose sessionStart an interactive session (default)
goose session --name feat/loginName a session for later resume
goose session --resumeResume the previous session
goose run "Refactor the utils module"One-shot non-interactive task
goose run --stdinRead the task from stdin
Configure & Auth 5
goose configureInteractive provider/key setup
goose configure extensionsConfigure extension connections
export GOOSE_PROVIDER=anthropicSet the provider env var
export GOOSE_MODEL=claude-sonnetSet the default model
export ANTHROPIC_API_KEY=sk-ant-...Set the model API key
Extensions (MCP) 5
goose extensions listList 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 extensionsInteractive extension config
Recipes & Diagnostics 5
goose cook recipe.yamlRun a multi-step workflow from a recipe
goose doctorDiagnose environment/config issues
goose logsView run logs
goose updateUpgrade Goose to the latest
goose completion bashGenerate shell completion
Serve & Debug 5
goose server startStart the Goose server
goose server stopStop the server
goose server statusCheck server status
goose sessions listList historical sessions
goose chatJump 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 prodRun with a named profile
goose configure --helpShow configure subcommand help
goose --versionPrint 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