Goose CLI Cheatsheet - Block / Linux Foundation AAIF Agent Full Reference
Goose is a general-purpose terminal AI agent under the Linux Foundation AAIF (Rust, Apache-2.0), for developers and ops who want one capable agent to manipulate local files, run commands, and connect to 15+ model providers and 70+ MCP extensions. Broader than code-focused agents, it fits handing daily automation and cross-tool workflows to a single agent. This sheet covers interactive sessions, one-shot runs, extension management, and goose doctor diagnostics.
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
Each command links to its official documentation below, so you can verify the latest usage and read deeper.
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