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
88 lines
3.0 KiB
Plaintext
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.
|