用途
Shire 定位为“智能体生活并繁荣的地方”,是一个面向 AI 智能体的基础设施层。大多数 AI 智能体工具遵循同一模式:用户给出指令,智能体执行,返回输出,随后智能体消失,下次再从零开始。Shire 试图改变这一点——让智能体在会话之间持久存在,彼此自主通信,并在既有工作成果上继续构建。用户提供反馈、迭代、调整方向,体验更接近与一个真实团队协作。
主要能力
- 兼容任意模型:不锁定单一 AI 供应商,支持 Claude Code、OpenCode、Pi Agent 和 Codex 等智能体运行框架(harness)。Shire 作为基础设施层,用户可自行选择适合工作流的模型。
- 智能体自主通信:智能体可自行发现同伴并协作,无需编排器(orchestrator)。支持直接消息、共享上下文,实现智能体之间的真实团队协作。
- 社区目录:可浏览并部署社区维护的预构建智能体模板库(由 agency-agents 提供支持),快速启动一支有能力的团队。
- 共享驱动器:所有智能体共用的公共文件系统,便于围绕共享产物开展协作。
- 定时任务:通过一次性或周期性定时消息自动化智能体工作,可设置自定义间隔,让智能体自动运行。
- 告警通道:当智能体需要关注时获得通知,可按项目配置将告警发送到 Discord、Slack 或 Telegram。
- 智能体技能:上传自定义工具和指令以扩展智能体能力,技能按智能体在会话之间持久保存。
- 多项目架构:将智能体组织到不同项目中,每个项目拥有自己的共享驱动器、设置和环境。
- 实时仪表盘:通过带流式更新的实时 Web UI 监控、聊天和管理智能体。
- 可选认证:使用用户名/密码登录保护实例,基于 JWT,支持自动令牌刷新、速率限制和安全 Cookie 处理;本地使用时默认禁用。
使用方式
通过 npm 全局安装 Shire,无需其他依赖:
npm install -g agents-shire
安装后访问 localhost:8080 打开仪表盘。该命令会为对应平台(macOS、Linux 或 Windows)安装独立二进制文件,所有数据存储在 ~/.shire/。
配置智能体运行框架
Shire 支持多种智能体运行框架,每个智能体在仪表盘中配置对应的框架类型。
Claude Code:安装 Claude Code 并通过以下方式之一完成认证。
OpenCode:安装 OpenCode 并设置所使用供应商的 API 密钥。OpenCode 会从环境变量和 .env 文件自动检测 API 密钥;Shire 自动管理 OpenCode 服务器进程,无需手动执行 opencode serve。注意模型格式:OpenCode 要求 provider/model 格式(例如 anthropic/claude-sonnet-4-6、openrouter/google/gemini-2.5-pro),这与其他只接受模型名称的框架不同。完整支持的供应商和模型列表见 OpenCode 供应商文档。
Pi Agent:使用 @mariozechner/pi-coding-agent SDK,支持多种 AI 供应商。将所需供应商的 API 密钥设置为环境变量,也可将密钥存放在 ~/.pi/agent/auth.json(优先于环境变量)。完整支持的供应商和订阅服务列表见 Pi Agent 文档。
Codex:安装 Codex CLI 并设置 OpenAI API 密钥。Codex 使用 OpenAI 模型(例如 o4-mini、gpt-4.1、codex-mini),详见 Codex 文档。
开发环境启动
开发模式下需要按所用框架安装对应依赖:Claude Code(仅在使用 claude_code 框架时)、OpenCode(仅在使用 opencode 框架时)、Codex CLI(仅在使用 codex 框架时)。默认使用 SQLite 存储,智能体作为本地进程运行,无需外部服务,所有数据存储在 ~/.shire/。
认证配置
默认情况下 Shire 不启用认证,适合本地开发。若要保护共享或远程实例,同时设置 SHIRE_USERNAME 和 SHIRE_PASSWORD。启用后,仪表盘会显示登录页,所有 API/WebSocket 连接都需要有效的 JWT 令牌;签名密钥在首次启动时自动生成于 ~/.shire/.jwt-secret。
构建与发布
Shire 通过 npm 以独立二进制文件分发,无需运行时依赖。构建命令会将后端编译为独立二进制文件,并预构建前端资源。发布通过 GitHub Actions 自动化,打标签即可触发工作流,构建各平台二进制并发布:@agents-shire/cli-darwin-arm64(macOS Apple Silicon)、@agents-shire/cli-darwin-x64(macOS Intel)、@agents-shire/cli-linux-x64(Linux x64)、@agents-shire/cli-linux-arm64(Linux ARM)、@agents-shire/cli-win32-x64(Windows x64),以及安装正确二进制文件的元包 agents-shire。
适用场景
适合希望让 AI 智能体长期存在、跨会话积累工作成果,并让多个智能体自主协作的用户;适合需要按项目组织智能体、共享文件与上下文、设置定时任务和告警通知的团队或个人;也适合希望自由选择底层模型供应商、在本地运行智能体而不依赖外部服务的开发者。
限制
资料未提供具体的收费、价格、性能指标或效果数据。认证默认关闭,用于共享或远程实例时需自行配置用户名和密码。不同运行框架对模型格式和 API 密钥的配置要求不同,需按对应文档设置。