Agent Deck
为已安装的 Pi 编码智能体提供原生 macOS 工作台,让会话、技能、提示词与并行任务一目了然、可控可管。
- Star 数
- ★ 124
- 最近更新
- 3 个月前
- License
- MIT
- 主语言
- Swift
- FA 评分
- 45/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 已经在用 Pi CLI、想要一个原生 Mac 界面同时观察多个会话与子代理状态的开发者。
- 不适合
- 使用 Windows 或 Linux 的团队(仅支持 macOS 26 与 Apple Silicon)
- 不想安装 Pi CLI 的用户——Agent Deck 本身不是运行时
- 需要 Intel Mac 或旧版 macOS 的团队
- 官网
- agentdeck.site ↗ 来自 GitHub 仓库设置
- 维护状态
- 近半年有提交最近提交 2026-08-01最新版本 v5.1.3(2026-07-24)
- 源码审查
- 45/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
Agent Deck 是一个用 Swift 6 和 SwiftUI 编写的原生 Mac 应用,它本身不是智能体运行时,而是围绕 Pi CLI 的工作空间。它以 JSONL RPC 模式启动你本机已安装的 Pi,把会话、工具调用、计划、文件预览与引导消息集中到一个窗口中展示。应用管理代理、技能、可复用提示词和斜杠命令的作用域,内置资源保持只读,自定义通过覆盖层完成,并在写入前显示写入目标。并行工作借助隔离的 git worktree 保持有序,可为会话或子代理分配独立分支后再合并回去。它要求 macOS 26(Tahoe)与 Apple Silicon,以签名并公证的 DMG 或 install.sh 分发,更新走 Sparkle。
应用以 JSONL RPC 模式启动本机 Pi CLI 并渲染实时会话:消息卡片、工具调用、计划、文件预览、附件与终端交接都在同一窗口内。它扫描并组织项目级或跨项目的 agents、skills、prompts 与 slash commands,显示其作用域并只在显式分配后生效;内置资源只读,定制走 override,写入目标在动手前可见。子代理由应用托管,可将研究、规划、实现或评审委派出去,report-only 子代理只写自己的产物而不触碰项目。会话与子代理可以拿到隔离的 git worktree,从 GitHub issue 起步,在分支内工作后审查、提交、推送或合并。另有模型与提供方浏览、会话/代理偏好、带掩码的全局环境密钥、项目级 Markdown 记忆(写入时做密钥扫描),以及用于查找、安装和更新 Pi 的 Doctor 与入门引导。
- 已经在用 Pi CLI、想要一个原生 Mac 界面同时观察多个会话与子代理状态的开发者。
- 需要把研究、规划、实现、评审拆给不同子代理并跟踪各自产物的团队。
- 从 GitHub issue 出发,希望在隔离 worktree 中改动、评审后再提交或合并的工程师。
- 为多个项目维护 agents、skills、提示词与斜杠命令,并需要清楚知道哪些文件真正进入了会话的人。
- 需要项目级 Markdown 记忆记录决策与 runbook,同时担心密钥误写入的个人或小团队。
- 想浏览可用模型与提供方、按会话切换偏好并集中管理全局环境密钥的用户。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
curl -fsSL https://raw.githubusercontent.com/a-streetcoder/agent-deck/main/install.sh | bash
- 安装说明涉及
- macOS
如何安装或部署这个 Agent?
需要 macOS 26(Tahoe)与 Apple Silicon。先安装 Pi CLI(入门引导也能代装),然后二选一:
curl -fsSL https://raw.githubusercontent.com/a-streetcoder/agent-deck/main/install.sh | bash或从 Releases 下载已签名并公证的 DMG,拖入 /Applications。脚本内容见仓库中的 install.sh,建议先阅读再执行。
从源码构建需要 Xcode 26.4+:
git clone https://github.com/a-streetcoder/agent-deck.git
cd agent-deck
open agent-deck.xcodeproj也可以用命令行构建:
xcodebuild -project agent-deck.xcodeproj -scheme agent-deck \
-configuration Debug -destination 'platform=macOS' \
CODE_SIGNING_ALLOWED=NO build如何使用这个 Agent?
首次打开时用 Doctor 与入门引导定位或安装 Pi CLI;如果 Pi 已在本机,应用会以 JSONL RPC 模式启动它。
在项目上下文中新建 Pi 会话,即可看到消息卡片、工具调用、计划与文件预览。为会话分配所需的 agents、skills、prompts 与 slash commands——磁盘上存在并不代表已启用,确认作用域后再开始。
需要并行时,给会话或子代理分配隔离的 git worktree,从 GitHub issue 起一条分支,在独立目录中完成改动,随后在原处审查并提交、推送或合并。
模型与提供方偏好、全局环境密钥(带掩码)、项目级 Markdown 记忆分别在对应视图中管理;记忆写入时会做密钥扫描。发布版每次启动会发送一条最小化的 app_opened 事件到 EU 托管的 PostHog,Debug、XCTest、预览与基准测试中该集成关闭。
这个 Agent 有哪些优点和局限?
- 原生 SwiftUI 应用,无 Electron 与内嵌 Web UI,使用系统快捷键与原生决策弹窗。
- 明确的作用域与写入可见性:内置资源只读、定制走 override、写入目标在开始前展示。
- report-only 子代理只写自己的产物,不会污染项目目录。
- 会话与子代理可使用隔离 git worktree,支持从 issue 起步并在事后合并。
- 签名并公证的发布包,配合 Sparkle 走标准 macOS 更新流程。
- MIT 许可,源码与详细文档(含系统提示词逻辑、记忆、模型设置)公开可查。
- 仅支持 macOS 26(Tahoe)与 Apple Silicon,Intel Mac 与旧系统无法使用。
- 不是独立运行时,必须先安装 Pi CLI;Pi 的行为与能力上限直接决定体验。
- 安装脚本通过 curl 管道到 bash 执行,需要自行审查安全性。
- 发布版默认向 EU 托管的 PostHog 发送启动事件,介意遥测的团队需评估。
- 从源码构建需要 Xcode 26.4+,模型调用成本需自行承担。
- 文档指向仓库内
agent-deck-documentation/目录,脱离仓库不便检索。
这个 Agent 与同类方案有什么区别?
README 明确把自己与 Pi CLI 区分开:Pi 是编码智能体运行时,Agent Deck 是其外部的原生 macOS 工作空间;同时明确说明自身不是 Web 包装器、也不是替代运行时,未点名其他竞品。
与相关度最高的同类 agent 并排比较关键指标。
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
证据显示产品在写入目标上有明确设计:内置资源只读、自定义走 override、报告型子代理只写自身产物、currentCheckout 需显式确认(loop-authoring、AGENTS.md、README 一致)。但 MCP 技能允许代理直接改写 ~/.pi/agent/mcp.json 并给出 shell 写入模板,且可存储密钥,最小权限与敏感数据处理仅部分落实;依赖安全仅见 Sparkle 版本锁定与签名/公证流程,未见依赖审计或漏洞缓解说明;回滚仅靠 git worktree 与 Sparkle 更新,缺少显式撤销/恢复流程;来源归属仅 README 提及 Pi 上游,未给出更细的出处追踪。故各项按证据扣分,未给满分。
README、AGENTS.md、技能文档对 Pi JSONL RPC、资源作用域、写入目标的描述彼此一致,自洽性较好;但依赖可用性仅靠 Xcode 26.4+/macOS 26/Apple Silicon 与 SwiftPM 解析,未见锁定清单或离线/降级说明;失败信息只在 release.yml 的 Xcode 选择与签名校验处有明确报错,产品运行时错误处理未见证据。
面向 macOS 26 Apple Silicon 的单一场景,受众与场景描述清楚;能力边界(Pi 是运行时、Agent Deck 是工作区、不替代运行时)表述明确;但触发精度仅靠技能 description 与 whenToUse 约定,缺少可验证的触发规则;环境适配极窄(仅 macOS 26 + Xcode 26.4+),跨平台/旧系统无说明。
信息架构清晰(README + agent-deck-documentation 分主题 + 技能目录);安装说明含 curl 管道安装与 DMG 两种路径并提示先读脚本;许可证为 MIT 且文件完整;但命名稳定性仅见 kebab-case 约定,无版本化命名策略;示例与 FAQ 仅截图与少量片段,无 FAQ;已知限制仅零散提及(内置 loop 模板禁用、无 by-reference agent 导入),未集中列出;版本化仅靠 release tag 与 Sparkle appcast,无 CHANGELOG;维护责任因发布者未验证而无法确认。
输出可用性较好:技能给出可复制的 frontmatter、JSON 配置与 upsert 脚本模板;边际价值在于把 Pi 会话、资源作用域与并行 worktree 组织成可见工作区,相对裸 CLI 有增量;但成本收益受限于仅 macOS 26 Apple Silicon、需已装 Pi、依赖 Xcode 构建,普通用户门槛偏高,故扣分。
README 的隐私声明(PostHog EU、仅 app_opened、Debug 禁用)与 release.yml 的签名/公证/Sparkle 注入步骤可相互印证,但均为自述,未见独立测试或第三方审计;事实与推断分离一般:文档混用产品承诺与实现细节,未标注哪些是已验证行为;跨源佐证仅限仓库内文件互证,缺少外部可核验来源。
- MCP 安装技能允许代理直接改写 ~/.pi/agent/mcp.json 并可能存储密钥,需人工复核写入内容与密钥处理。
- README 推荐 curl 管道安装脚本,虽提示先阅读,仍属高风险安装方式,建议改用签名 DMG。
- 仅支持 macOS 26 Apple Silicon,环境适配极窄,旧系统或 Intel 用户无法使用。
- 发布者身份未经验证,维护责任与更新路径无法确认,依赖其长期维护需谨慎。
- 依赖安全与漏洞缓解无文档证据,Sparkle 版本锁定之外未见审计。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v5.1.3 Agent Deck 5.1.3
发布说明摘录
What's new in 5.1.3 🐛 Bug fixes - Attachment pills now respond reliably when clicked.在 GitHub 查看 ↗ -
v5.1.2 Agent Deck 5.1.2
发布说明摘录
What's new in 5.1.2 ✨ New features - Preview agent profiles from new hover cards. 💪 Improvements - Cleaner assignment controls with centered checkboxes and visible collection updates. 🐛 Bug fixes - Fixed the agent profile popover layout.在 GitHub 查看 ↗ -
v5.1.1 Agent Deck 5.1.1
发布说明摘录
What's new in 5.1.1 🐛 Bug fixes - Unsent composer drafts now stay with their session when switching chats and remain available until the app closes. - Message cards now size styled text and attachment labels correctly without premature wrapping.在 GitHub 查看 ↗
常见问题
Agent Deck 自己会调用大模型吗?
可以在 Intel Mac 或 Windows 上用吗?
文件放在项目目录里就会自动进入会话吗?
并行任务怎么避免互相干扰?
会收集我的提示词或代码吗?
app_opened 事件,不含提示词、回复、代码或文件内容、项目名与路径、账号标识、凭据或截图;PostHog 为 EU 托管。Agent Deck 官网是什么?
Agent Deck 免费吗?
Agent Deck 开源吗?
Agent Deck 安全吗?
Agent Deck 还在维护吗?
Agent Deck 是谁开发的?
谢谢反馈,我们会据此改进页面。