🗃️ Managing Sessions
3 items
🗃️ Context Engineering
12 items
🗃️ Recipes
4 items
🗃️ Managing Tools
4 items
📄️ Managing Projects
goose Projects automatically track your working directories and associated sessions, making it easy to resume work across multiple codebases with full context preservation.
📄️ 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 several commands for managing sessions, configurations and extensions. This guide covers all available 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
🗃️ Security
3 items
📄️ MCP Sampling
Transforms MCP servers into intelligent agents that can think, analyze, and make decisions using goose's AI
🗃️ MCP Apps and MCP-UI
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 goosed server process in the background on the same machine. You can also run goosed separately — for example, on a remote VM or a different machine on your network — and point goose Desktop at it.
📄️ Multi-Model Config
Approaches for configuring model-switching behavior to optimize for cost, performance, and results.
📄️ goose in ACP Clients
Client applications that support the Agent Client Protocol (ACP) can connect natively to goose. This integration allows you to seamlessly interact with goose directly from the client.
📄️ Enhanced Code Editing
Use AI models to intelligently apply code changes
📄️ Codebase Analysis
Understand codebases with semantic analysis and call graphs
📄️ Customizing the Sidebar
Personalize how you navigate goose Desktop by changing the sidebar's look, position, and behavior
📄️ Sandbox for goose Desktop
Optional sandboxing for goose Desktop to control file access, filter network traffic, and enforce security policies on macOS
📄️ 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.