Files
wehub-resource-sync 8a21a212f8
Deploy Documentation / deploy (push) Has been cancelled
Canary / build-cli (push) Has been skipped
Canary / Upload Install Script (push) Has been skipped
Canary / bundle-desktop (push) Has been skipped
Canary / bundle-desktop-intel (push) Has been skipped
Canary / bundle-desktop-linux (push) Has been skipped
Canary / bundle-desktop-windows (push) Has been skipped
Canary / bundle-desktop-windows-cuda (push) Has been skipped
Canary / Release (push) Has been skipped
Cargo Deny / deny (push) Has been skipped
Unused Dependencies / machete (push) Has been skipped
Canary / Prepare Version (push) Failing after 1s
Live Provider Tests / check-fork (push) Failing after 0s
Create Minor Release PR / check-version-bump-pr (push) Has been skipped
Publish Ask AI Bot Docker Image / docker (push) Failing after 1s
Live Provider Tests / changes (push) Has been skipped
Scorecard supply-chain security / Scorecard analysis (push) Has been skipped
Publish Docker Image / docker (push) Failing after 1s
CI / changes (push) Failing after 8s
Create Minor Release PR / release (push) Has been skipped
Live Provider Tests / Smoke Tests (push) Has been cancelled
Live Provider Tests / Smoke Tests (Code Execution) (push) Has been cancelled
Live Provider Tests / Compaction Tests (push) Has been cancelled
CI / Build Rust Project on Windows (push) Has been cancelled
Live Provider Tests / Build Binary (push) Has been cancelled
CI / Lint Rust Code (push) Has been cancelled
CI / Check Generated Schemas are Up-to-Date (push) Has been cancelled
CI / Test and Lint Electron Desktop App (push) Has been cancelled
CI / Check Rust Code Format (push) Has been cancelled
CI / Build and Test Rust Project (push) Has been cancelled
CI / Check MSRV (push) Has been cancelled
chore: import upstream snapshot with attribution
2026-07-13 12:04:08 +08:00

88 lines
3.0 KiB
Plaintext

# goose
goose is an extensible, open source AI agent that enhances software development by automating coding tasks.
It runs locally on your machine and connects to various tools and services through the Model Context Protocol (MCP).
goose is available as both a desktop application and a command-line interface (CLI).
## Key Features
- **Local-first**: Runs on your machine with full access to your development environment
- **Extensible**: Add capabilities through MCP extensions (servers)
- **Multi-provider**: Works with OpenAI, Anthropic, Google, Meta, Ollama, and more
- **Cross-platform**: Available on macOS, Linux, and Windows
- **Open source**: MIT licensed, community-driven development
## Core Concepts
- **Extensions**: Plugins that give goose new capabilities via MCP servers (GitHub, Slack, databases, etc.)
- **Recipes**: Reusable task templates that can be shared and automated
- **Sessions**: Conversation contexts that maintain state across interactions
- **Providers**: LLM backends that power goose (OpenAI, Anthropic, Ollama, etc.)
- **Goosehints**: Project-specific instructions that customize goose behavior
## Documentation
- Quickstart: /docs/quickstart
- Installation: /docs/getting-started/installation
- LLM Providers: /docs/getting-started/providers
- Using Extensions: /docs/getting-started/using-extensions
- CLI Commands: /docs/guides/goose-cli-commands
- Recipes Guide: /docs/guides/recipes/
- Tutorials: /docs/tutorials/
- MCP Servers/Extensions: /docs/mcp/
## Installation
### macOS/Linux/Windows (CLI)
```sh
curl -fsSL https://github.com/aaif-goose/goose/releases/download/stable/download_cli.sh | bash
```
### macOS (Homebrew)
```sh
brew install --cask block-goose
```
Desktop applications are available for macOS, Linux, and Windows at /docs/getting-started/installation
## Common Use Cases
- Automating repetitive coding tasks
- Interacting with GitHub (PRs, issues, code review)
- Database queries and management
- File system operations
- Web scraping and API interactions
- CI/CD pipeline management
- Code generation and refactoring
## Built-in Extensions
- **Developer**: Shell commands, file editing, code analysis
- **Computer Controller**: System automation, web scraping
- **Memory**: Persistent storage across sessions
- **Todo**: Task management within sessions
- **Extension Manager**: Enable/disable extensions dynamically
- **Chat Recall**: Search and reference past conversations
## Configuration
goose configuration is stored in `~/.config/goose/` with:
- `profiles.yaml`: Provider and extension settings
- `config.yaml`: Global preferences
Project-specific hints can be added via `.goosehints` and/or `AGENT.md` files.
## Links
- Website: https://goose-docs.ai/
- GitHub: https://github.com/aaif-goose/goose
- Discord: https://discord.gg/goose-oss
- Extensions Registry: https://goose-docs.ai/extensions/
- Blog: https://goose-docs.ai/blog/
## About
goose is developed by AAIF (Agentic AI Foundation) as an open source project under the Apache 2.0 license.