mirror of
https://github.com/block/goose.git
synced 2026-08-24 15:55:31 +00:00
0f32f8d0a9
Some checks failed
Canary / Prepare Version (push) Waiting to run
Canary / build-cli-linux (push) Blocked by required conditions
Canary / Upload Install Script (push) Waiting to run
Canary / bundle-macos-arm64 (push) Blocked by required conditions
Canary / bundle-macos-x64 (push) Blocked by required conditions
Canary / bundle-desktop-linux (push) Blocked by required conditions
Canary / bundle-windows (push) Blocked by required conditions
Canary / bundle-windows-cuda (push) Blocked by required conditions
Canary / Release (push) Blocked by required conditions
Unused Dependencies / machete (push) Waiting to run
CI / Check MSRV (push) Blocked by required conditions
CI / Lint Rust Code (push) Blocked by required conditions
CI / changes (push) Waiting to run
CI / Check Rust Code Format (push) Blocked by required conditions
CI / Build and Test Rust Project (push) Blocked by required conditions
CI / Build and Test TLS Backend (native-tls) (push) Blocked by required conditions
CI / Build and Test TLS Backend (rustls-tls) (push) Blocked by required conditions
CI / Build Rust Project on Windows (push) Waiting to run
CI / Check Generated Schemas are Up-to-Date (push) Blocked by required conditions
CI / Test and Lint Electron Desktop App (push) Blocked by required conditions
Create Minor Release PR / check-version-bump-pr (push) Waiting to run
Create Minor Release PR / release (push) Blocked by required conditions
Live Provider Tests / Build Binary (push) Blocked by required conditions
Live Provider Tests / changes (push) Blocked by required conditions
Live Provider Tests / check-fork (push) Waiting to run
Publish Docker Image / docker (push) Waiting to run
Scorecard supply-chain security / Scorecard analysis (push) Waiting to run
Live Provider Tests / Smoke Tests (push) Blocked by required conditions
Live Provider Tests / Smoke Tests (Code Execution) (push) Blocked by required conditions
Live Provider Tests / Compaction Tests (push) Blocked by required conditions
Deploy Documentation / deploy (push) Has been cancelled
Cargo Deny / deny (push) Has been cancelled
Publish Ask AI Bot Docker Image / docker (push) Has been cancelled
Co-authored-by: Douwe M Osinga <douwe@sidewalklabs.com> Co-authored-by: Jasper Hugo <jasper@jasperhugo.com>
87 lines
3 KiB
Text
87 lines
3 KiB
Text
# 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/n8R5VaWDAn
|
|
- 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.
|