Agent Deck

为已安装的 Pi 编码智能体提供原生 macOS 工作台,让会话、技能、提示词与并行任务一目了然、可控可管。

Star 数
★ 124
最近更新
3 个月前
License
MIT
主语言
Swift

30 秒速览

运行形态
桌面应用命令行工具
可在哪里用
平台专用
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Pi CLImacOS 26(Tahoe)Apple SiliconXcode 26.4+(从源码构建时)Shell / 命令行网络访问本地文件系统
典型场景
已经在用 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)

这个 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 与入门引导。

  1. 已经在用 Pi CLI、想要一个原生 Mac 界面同时观察多个会话与子代理状态的开发者。
  2. 需要把研究、规划、实现、评审拆给不同子代理并跟踪各自产物的团队。
  3. 从 GitHub issue 出发,希望在隔离 worktree 中改动、评审后再提交或合并的工程师。
  4. 为多个项目维护 agents、skills、提示词与斜杠命令,并需要清楚知道哪些文件真正进入了会话的人。
  5. 需要项目级 Markdown 记忆记录决策与 runbook,同时担心密钥误写入的个人或小团队。
  6. 想浏览可用模型与提供方、按会话切换偏好并集中管理全局环境密钥的用户。

安装与配置要点

摘自下方的安装和使用说明,以项目 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 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
Agent Deck 当前 45 · 缺口较多 桌面应用免费 + 模型费 ★ 124 3 个月前 Swift —
Kooky 68 · 存在缺口 桌面应用免费 ★ 657 1 个月前 Swift Codex · Claude Code
agterm 75 · 存在缺口 桌面应用免费 ★ 759 今天 Swift Codex · Claude Code
zerostack 69 · 存在缺口 命令行工具免费 + 模型费 ★ 1.8k 2 天前 Rust OpenAI API · Claude API

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
缺口较多
45/ 100 五分制 2.3 / 5
信任安全 12/29
可靠稳定 6/14
适用触发 9/18
规范维护 8/18
有效结果 7/13
证据核验 3/8
查看各维度的扣分理由
信任安全12 / 29 · 2.1/5

证据显示产品在写入目标上有明确设计:内置资源只读、自定义走 override、报告型子代理只写自身产物、currentCheckout 需显式确认(loop-authoring、AGENTS.md、README 一致)。但 MCP 技能允许代理直接改写 ~/.pi/agent/mcp.json 并给出 shell 写入模板,且可存储密钥,最小权限与敏感数据处理仅部分落实;依赖安全仅见 Sparkle 版本锁定与签名/公证流程,未见依赖审计或漏洞缓解说明;回滚仅靠 git worktree 与 Sparkle 更新,缺少显式撤销/恢复流程;来源归属仅 README 提及 Pi 上游,未给出更细的出处追踪。故各项按证据扣分,未给满分。

可靠稳定6 / 14 · 2.1/5

README、AGENTS.md、技能文档对 Pi JSONL RPC、资源作用域、写入目标的描述彼此一致,自洽性较好;但依赖可用性仅靠 Xcode 26.4+/macOS 26/Apple Silicon 与 SwiftPM 解析,未见锁定清单或离线/降级说明;失败信息只在 release.yml 的 Xcode 选择与签名校验处有明确报错,产品运行时错误处理未见证据。

适用触发9 / 18 · 2.5/5

面向 macOS 26 Apple Silicon 的单一场景,受众与场景描述清楚;能力边界(Pi 是运行时、Agent Deck 是工作区、不替代运行时)表述明确;但触发精度仅靠技能 description 与 whenToUse 约定,缺少可验证的触发规则;环境适配极窄(仅 macOS 26 + Xcode 26.4+),跨平台/旧系统无说明。

规范维护8 / 18 · 2.2/5

信息架构清晰(README + agent-deck-documentation 分主题 + 技能目录);安装说明含 curl 管道安装与 DMG 两种路径并提示先读脚本;许可证为 MIT 且文件完整;但命名稳定性仅见 kebab-case 约定,无版本化命名策略;示例与 FAQ 仅截图与少量片段,无 FAQ;已知限制仅零散提及(内置 loop 模板禁用、无 by-reference agent 导入),未集中列出;版本化仅靠 release tag 与 Sparkle appcast,无 CHANGELOG;维护责任因发布者未验证而无法确认。

有效结果7 / 13 · 2.7/5

输出可用性较好:技能给出可复制的 frontmatter、JSON 配置与 upsert 脚本模板;边际价值在于把 Pi 会话、资源作用域与并行 worktree 组织成可见工作区,相对裸 CLI 有增量;但成本收益受限于仅 macOS 26 Apple Silicon、需已装 Pi、依赖 Xcode 构建,普通用户门槛偏高,故扣分。

证据核验3 / 8 · 1.9/5

README 的隐私声明(PostHog EU、仅 app_opened、Debug 禁用)与 release.yml 的签名/公证/Sparkle 注入步骤可相互印证,但均为自述,未见独立测试或第三方审计;事实与推断分离一般:文档混用产品承诺与实现细节,未标注哪些是已验证行为;跨源佐证仅限仓库内文件互证,缺少外部可核验来源。

风险与缓解建议
  • MCP 安装技能允许代理直接改写 ~/.pi/agent/mcp.json 并可能存储密钥,需人工复核写入内容与密钥处理。
  • README 推荐 curl 管道安装脚本,虽提示先阅读,仍属高风险安装方式,建议改用签名 DMG。
  • 仅支持 macOS 26 Apple Silicon,环境适配极窄,旧系统或 Intel 用户无法使用。
  • 发布者身份未经验证,维护责任与更新路径无法确认,依赖其长期维护需谨慎。
  • 依赖安全与漏洞缓解无文档证据,Sparkle 版本锁定之外未见审计。
证据充分度:低 评估于 2026年11月12日 审查版本 9efbe6c1dc2a
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/a-streetcoder-agent-deck.svg?lang=zh)](https://followagents.com/zh/agents/a-streetcoder-agent-deck)
<a href="https://followagents.com/zh/agents/a-streetcoder-agent-deck"><img src="https://followagents.com/badge/a-streetcoder-agent-deck.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. 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 查看 ↗
  2. 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 查看 ↗
  3. 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 自己会调用大模型吗?
不会。它启动你本机已安装的 Pi CLI 并以其 JSONL RPC 模式驱动会话,模型与提供方由 Pi 侧配置决定,模型费用由你自行承担。
可以在 Intel Mac 或 Windows 上用吗?
不行。README 明确要求 macOS 26(Tahoe)与 Apple Silicon,且发行物为 Mac 原生应用。
文件放在项目目录里就会自动进入会话吗?
不会。agents、skills、prompts 与命令需要被显式分配,内置资源保持只读,自定义通过 override 完成,写入目标会在开工前展示。
并行任务怎么避免互相干扰?
可为会话和子代理分配隔离的 git worktree,各自在独立分支上工作,状态集中跟踪,最后由你决定合并时机。
会收集我的提示词或代码吗?
按 README 描述,发布版每次启动只发送一条 app_opened 事件,不含提示词、回复、代码或文件内容、项目名与路径、账号标识、凭据或截图;PostHog 为 EU 托管。
Agent Deck 官网是什么?
Agent Deck 的 GitHub 仓库填写的官网是 https://agentdeck.site。这个链接由仓库作者设置;源码在 GitHub(a-streetcoder/agent-deck)。
Agent Deck 免费吗?
软件本身免费,但 Agent Deck 要调用 AI 模型,模型的调用费用由你向模型服务商支付(也可以接本地模型)。
Agent Deck 开源吗?
开源。源码在 GitHub(a-streetcoder/agent-deck),许可证是 MIT。
Agent Deck 安全吗?
FollowAgents 的 FARS 评审(2026年11月12日)给 Agent Deck 的“信任与安全”打了 12/29 分。评审检查的 8 项安全措施没有完全缺失的。
Agent Deck 还在维护吗?
更新变慢了:GitHub 上最近一次提交是 2026-08-01,在最近半年内,但不在最近 30 天内。最新版本是 v5.1.3(2026-07-24)。
Agent Deck 是谁开发的?
Agent Deck 由 GitHub 账号 a-streetcoder 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念