ποΈ Managing Sessions
3 items
ποΈ Context Engineering
11 items
ποΈ Recipes
4 items
ποΈ Managing Tools
4 items
ποΈ Updating goose
The goose CLI and desktop apps are under active and continuous development. To get the newest features and fixes, you should periodically update your goose client using the following instructions.
ποΈ CLI Commands
goose provides a command-line interface (CLI) with commands for managing sessions, configurations and extensions. This guide covers the main CLI commands and interactive session features.
ποΈ CLI Providers
Use Claude Code, Codex, Cursor Agent, or Gemini CLI subscriptions in goose
ποΈ ACP Providers
Use ACP agents like Claude Code and Codex as goose providers with extension support
ποΈ Configuration Files
goose uses YAML configuration files to manage settings and extensions. The primary config file is located at:
ποΈ Environment Variables
goose supports various environment variables that allow you to customize its behavior. This guide provides a comprehensive list of available environment variables grouped by their functionality.
ποΈ Quick Tips
Best practices for working with goose
ποΈ Tool Shim
The tool shim is an experimental feature. Configuration options and behavior may change in future releases.
ποΈ Security
3 items
ποΈ MCP Apps
1 item
ποΈ MCP Elicitation
How extensions can request structured information from you during a task
ποΈ MCP Roots
How goose shares your working directory with roots-aware MCP extensions
ποΈ Custom Distributions
goose is designed to be forked and customized. You can create your own "distro" of goose preconfigured with specific providers, bundled extensions, custom branding, and tailored workflows for your organization or audience.
ποΈ LLM Rate Limits
Rate limiting is the process of restricting the number of requests a user or application can send to an LLM API within a specific timeframe. LLM providers enforce this with the purpose of managing resources and preventing abuse.
ποΈ Logging System
goose uses a unified storage system for conversations and interactions. All conversations and interactions (both CLI and Desktop) are stored locally in the following locations:
ποΈ Usage Data
On first use, goose asks for permission to collect anonymous usage data to help improve the product. You can change this setting at any time.
ποΈ File Management
Efficiently find and reference files in goose Desktop and follow best practices for safe file operations
ποΈ Run Tasks
When working with the goose CLI, you can pass files and instructions to the goose run command to execute tasks and workflows. This could be a simple one-liner command or a complex set of instructions stored in a file.
ποΈ Extension Allowlist
goose is an extensible framework that, by default, allows you to install any MCP server. However, you may want stricter controls on which MCP servers can be installed as extensions (e.g. in a corporate setting).
ποΈ Remote Server
goose Desktop normally runs its own goose serve ACP server process in the background on the same machine. You can also run goose serve separately β for example, on a remote VM or a different machine on your network β and point goose Desktop at it.
ποΈ Offline Docs
The goose-doc-guide skill reads official goose documentation before answering
ποΈ Roaming Agents
Roaming agents let you reach a running goose agent from another machine over a
ποΈ Multi-Model Config
Approaches for configuring model-switching behavior to optimize for cost, performance, and results.
ποΈ Codebase Analysis
Understand codebases with semantic analysis and call graphs
ποΈ Azure AI Foundry
Use OpenAI, Anthropic, and partner model deployments from an Azure AI Foundry project
ποΈ Customizing the Sidebar
Personalize how you navigate goose Desktop by changing the sidebar's look, position, and behavior
ποΈ VMware Tanzu Platform
Connect goose to VMware Tanzu Platform AI Services
ποΈ VMware Tanzu Platform - CLI Testing Guide
Prerequisites
ποΈ Terminal Integration
Talk to goose directly from your shell prompt. Instead of switching to a separate REPL session, stay in your terminal and call goose when you need it.