开源 · 本地运行 · 自动化

本地 AI 代理
自动化工程任务

goose 是 Block 开源的智能 AI 代理,在你的机器上本地运行。 支持 20+ 大模型提供商,通过 MCP 协议无限扩展能力, 可自主完成从代码编写到项目部署的完整工程流程。

32k+
⭐ Stars
2.9k+
🍴 Forks
20+
🤖 LLM 提供商
v1.26
📦 版本
Rust MCP Protocol Apache-2.0
goose — bash
$ goose session
starting session | goose v1.26.0
provider: anthropic | claude-sonnet-4-5

G 帮我创建一个 REST API 项目...

→ 分析需求中...
✔ 创建项目结构
✔ 初始化 package.json
✔ 编写 Express 服务代码
✔ 配置数据库连接
✔ 生成 API 文档
✔ 运行测试 (全部通过)

🪿 项目已就绪,共完成 6 个步骤

$
自主完成任务
🔌 MCP 无限扩展
核心特性

不只是代码建议
而是真正的自主工程代理

goose 可以构建整个项目、编写并执行代码、调试错误、编排工作流,并与外部 API 交互 — 全部自主完成

🤖

自主任务执行

从原型开发到生产部署,goose 能自主完成完整的工程流程,包括项目搭建、代码编写、测试运行和错误修复,无需持续人工干预。

🔀

任意 LLM 提供商

支持 20+ 大模型提供商,包括 Claude、GPT-4、Gemini、Llama 等,支持多模型配置以优化性能和成本,也支持本地运行的 Ollama 模型。

🔌

MCP 扩展生态

基于 Model Context Protocol 标准,可连接任何 MCP 服务器作为扩展,访问数据库、API、开发工具等海量生态能力,也可自定义扩展。

💻

桌面 + CLI 双端

提供图形化桌面应用(支持 macOS、Linux、Windows)和功能完整的命令行界面,满足不同工作场景和个人偏好,无缝切换工作流。

🧠

智能上下文管理

自动压缩和管理上下文窗口,通过更快速的小模型进行摘要,删除无关内容,使用差异化编辑替代全量重写,有效控制 token 成本。

🛡️

精细权限控制

支持工具权限管理、.gooseignore 文件排除敏感目录,提供多种权限模式(完全自主、智能审批、逐步审批),保护代码安全。

🔄

错误恢复机制

将运行错误、JSON 解析失败、工具缺失等异常作为工具响应反馈给模型,让 AI 自主分析并修复错误,保证任务流程不中断。

📝

Recipe 配方系统

通过 YAML 格式的 Recipe 文件定义可复用的自动化工作流,支持参数化配置和子任务编排,轻松分享和复用常见的工程流程模板。

🖥️

自定义发行版

支持构建自定义 goose 发行版,预配置特定提供商、扩展集合和品牌元素,适合企业内部部署和团队标准化工具链建设。

系统架构

清晰的三层架构设计

goose 由界面层、代理层和扩展层三部分组成,通过 MCP 协议实现高度模块化

👤
用户请求
自然语言描述任务需求
🖥️
桌面应用
GUI 图形界面
⌨️
CLI 命令行
终端交互界面
会话管理
🧠
Agent 代理核心
管理交互循环、LLM 调用、上下文修订、错误恢复
MCP Protocol
🛠️
Developer
代码执行
🖱️
Computer
系统控制
🧩
自定义 MCP
第三方扩展
💾
Memory
记忆持久化
交互循环工作原理: 用户请求 → Agent 将请求和工具列表发给 LLM → LLM 生成工具调用指令 → Agent 执行工具调用并收集结果 → 将结果反馈给 LLM → 上下文修订 → 生成最终响应,循环直到任务完成。
模型兼容性

支持 20+ 大模型 提供商

无论使用云端 API 还是本地部署的开源模型,goose 都能无缝集成

🤖
Anthropic Claude
OpenAI GPT
💎
Google Gemini
🦙
Ollama 本地
Groq
☁️
Amazon Bedrock
🔷
Azure OpenAI
🌊
Mistral AI
🐙
GitHub Copilot
🐋
Docker Runner
❄️
Snowflake
🛤️
OpenRouter
还支持 GCP Vertex AI、Databricks、LiteLLM、Venice AI、xAI Grok、OVHcloud AI、Ramalama、ChatGPT Codex 等 20+ 提供商,以及所有兼容 OpenAI API 格式的自托管模型
CLI 提供商: 除 API 提供商外,goose 还支持通过已安装的 CLI 工具使用模型,包括 Claude Code、OpenAI Codex CLI、Cursor Agent 和 Gemini CLI, 充分利用你现有的订阅服务,无需额外付费。
扩展生态

内置强大扩展,开箱即用

goose 内置多款扩展,覆盖开发、自动化、记忆、可视化等核心场景

🛠️
Developer
文件编辑、Shell 命令执行、项目搭建、代码分析,开发者的瑞士军刀
默认启用
🖱️
Computer Controller
网页抓取、文件缓存、系统自动化操作,控制整个计算机环境
🧠
Memory
跨会话记忆用户偏好和项目上下文,让 goose 越用越懂你
📊
Auto Visualiser
自动生成数据可视化图表,将复杂数据转化为直观的可视化展示
📋
Todo
跨会话任务列表管理,追踪进度,让 goose 记住你的未完成任务
默认启用
🔍
Chat Recall
跨所有历史会话搜索对话内容,快速找回之前的工作成果
🧩
Extension Manager
在会话中动态发现、启用和禁用扩展,灵活调整 goose 的能力集合
默认启用
🤖
Summon
加载技能和 Recipe 配方,委派任务给子代理,实现复杂并行工作流
默认启用
💭
Top of Mind
向 goose 的工作记忆中注入持久指令,每轮对话都自动应用你的全局偏好
快速安装

一条命令即可开始

选择适合你平台和使用方式的安装方案

选择 CLI 工具或桌面应用:

1

方式一:脚本安装 CLI(推荐)

运行以下命令自动安装最新版本的 goose CLI:

bash
$ curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash
2

方式二:Homebrew 安装

使用 Homebrew 安装 CLI 或桌面应用,支持自动更新:

bash
# 安装 CLI $ brew install block-goose-cli # 或安装桌面应用 $ brew install --cask block-goose
3

首次配置

安装后运行配置向导,选择 LLM 提供商并设置 API Key:

bash
$ goose configure
4

开始使用

bash
$ goose session # 在交互模式下告诉 goose 你想做什么
1

脚本安装 CLI

bash
$ curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash
2

安装桌面应用(Debian/Ubuntu)

bash
# 下载 .deb 安装包后执行 $ sudo dpkg -i goose-desktop.deb
3

配置并启动

bash
$ goose configure $ goose session
1

PowerShell 安装 CLI

powershell
# 在 PowerShell 中运行 Invoke-Expression (Invoke-WebRequest -Uri "https://github.com/block/goose/releases/download/stable/download_cli.ps1" -UseBasicParsing).Content
2

也可使用 WSL(推荐)

在 Windows Subsystem for Linux 中运行和在 Linux 下完全一样:

bash
$ curl -fsSL https://github.com/block/goose/releases/download/stable/download_cli.sh | bash
1

使用 Docker 运行 goose

适合在容器化环境中使用或隔离运行:

bash
$ docker run --rm -it \ -e ANTHROPIC_API_KEY=your_api_key \ -v $(pwd):/workspace \ ghcr.io/block/goose:latest session
2

从源码构建

bash
$ git clone https://github.com/block/goose.git $ cd goose $ source bin/activate-hermit $ cargo build --release
实际应用

告诉 goose 你想要什么

从简单脚本到复杂系统,goose 能理解你的意图并自主完成任务

01

全栈项目搭建

一句话描述需求,goose 自主完成项目脚手架创建、依赖安装、数据库配置、API 接口实现和单元测试编写。

项目初始化 代码生成 自动化测试
02

代码调试与重构

将代码和错误信息告诉 goose,它会分析根因、修复 Bug、进行性能优化,并确保测试全部通过。

Bug 修复 性能优化 代码重构
03

CI/CD 流水线配置

描述你的部署需求,goose 自动生成 GitHub Actions 工作流、Docker 配置和部署脚本,完整配置 DevOps 流程。

GitHub Actions Docker 自动部署
04

数据处理与分析

上传数据文件,让 goose 编写分析脚本、生成可视化图表、提取关键洞察,并输出格式化的分析报告。

数据分析 可视化 报告生成
05

API 集成与自动化

告诉 goose 需要集成哪些第三方服务,它会自动查阅文档、编写集成代码、处理认证逻辑和错误处理。

API 集成 认证处理 自动化脚本
06

文档生成与维护

分析现有代码库,自动生成 API 文档、README、变更日志和开发指南,保持文档与代码同步更新。

API 文档 README 变更日志

Recipe 工作流配方

通过 YAML 格式的 Recipe 文件定义可复用的自动化工作流, 支持参数化配置、子任务编排和并行处理,一次编写多次复用。

  • YAML 声明式工作流定义
  • 支持变量参数化
  • 子代理并行任务分发
  • 可分享给团队使用
  • 内置扫描器检测安全风险
recipe.yaml
# goose Recipe 配方示例 version: "1.0" title: "Full Stack API Setup" description: "搭建完整的 REST API 项目" parameters: - name: project_name description: "项目名称" - name: database description: "数据库类型" default: "postgres" prompt: | 创建名为 {{ project_name }} 的 REST API: 1. 初始化 Node.js + Express 项目 2. 配置 {{ database }} 数据库连接 3. 实现用户认证 JWT 4. 生成 API 文档 5. 编写单元测试并运行
bash
# 运行 Recipe $ goose run recipe.yaml \ --param project_name=myapi \ --param database=mysql
常用命令

CLI 命令参考

会话管理
# 开启新会话 $ goose session # 恢复上次会话 $ goose session --resume # 列出所有历史会话 $ goose session --list # 从文件运行任务 $ goose run task.txt
配置管理
# 交互式配置向导 $ goose configure # 查看当前配置信息 $ goose info # 查看详细配置(含环境变量) $ goose info --verbose # 更新到最新版本 $ goose update
扩展管理
# 快速添加内置扩展 $ goose mcp developer # 运行 MCP 服务器 $ goose mcp start my-server # 查看版本 $ goose --version # 查看帮助 $ goose --help
加入社区

与全球开发者共同建设

goose 是一个活跃的开源社区,欢迎所有开发者参与贡献

现在就让 goose
帮你飞速完成工作

开源免费 · 本地运行 · 支持任意 LLM · 无限扩展
32,000+ 开发者正在使用 goose 自动化他们的工程工作流