Agent Code – 用于管理 AI 编码代理的开源 Mac 应用

Agent Deck 是一款为 Pi 编码代理提供原生 macOS 界面的开源应用。它并不替代 Pi 或嵌入自己的代理运行时，而是启动已安装的 pi CLI 的 JSONL RPC 模式，管理周边资源和用户界面，并为 Pi 传递所需标志。结果既是为 Pi 会话提供的原生控制表面，也是组织代理、技能、提示和工作流的平台。

安装方面，用户可通过 Releases 页面下载最新签名的 .dmg 文件并拖入 Applications 文件夹。更新通过 Sparkle 自动推送。需要 macOS 26 (Tahoe) 和 Apple Silicon，且 Pi CLI 需安装并可被找到——首次启动时内置的 Doctor 工具会引导用户完成设置。

Agent Deck 的设计保证了范围始终可见：每个代理、技能和提示都会显示其来源（内置、全局、库或项目），并带有彩色标签、图标和文字。分配是显式的：Agent Deck 启动 Pi 时会使用 --no-skills 等标志，仅选择性启用已分配的内容。内置项为只读：自定义时会写入覆盖文件，原始文件不会被修改。所有写入操作都会显示将要写入的内容和位置。

会话与转录方面，支持流式转录，包含引导消息、思考块、工具调用、计划、内联差异、文件预览和颜色编码状态。实时计划清单跟踪代理的待办/进行中/完成/阻塞/跳过状态。丰富的编辑器支持粘贴处理、@ 文件建议、macOS 听写和附件。通过 Apple 的本地基础模型自动命名会话。空闲时自动释放系统资源。需要命令行调试时可通过终端交接。

并行工作方面，每个新会话可以在 Application Support 下创建独立的 Git 分支和工作树。用户可以在同时间运行三个代理处理三个功能，互不干扰。专用的 Merge 工具栏操作可将工作合并回源分支，并可配置工作树和分支的保留或丢弃。

端到端的 GitHub 集成包括：问题看板（打开/关闭列、子问题进度、依赖追踪、跨仓库搜索）、一键将问题转为会话（标题、正文、标签、评论作为上下文加载），以及通过 gh CLI 或原生 OAuth 进行 GitHub 认证。

子代理功能让父会话保持编排优先：将探索、规划、实现、审查等范围工作委托给原生子代理。内置启动包包括探索者、规划者、编码者、审查者。转录中摘要卡片显示每个代理的状态、令牌数和持续时间。当子代理需要人类指导时，超级请求卡片会呈现原生 macOS 决策界面。支持并行和链式图形。

代理、技能、提示和命令均在侧边栏中浏览和切换。技能可以从任何文件夹、GitHub 仓库或 skills.sh URL 通过无 blob 的稀疏克隆导入。导入时 Agent Deck 会生成 AI 摘要，帮助用户了解不熟悉的技能。可同步上游并解决冲突。提示是可重复使用的起点。代理包含名称、描述、系统提示覆盖、工具限制、模型覆盖、思考级别和生成的头像。

记忆功能为每个项目保留决策、操作手册、架构和先前失败，由代理在会话期间通过 agent_deck_memory_write 工具写入，存储为 Markdown，并在未来会话中根据预算注入。过时记忆会被标记为过时，不会删除。秘密扫描会阻止记忆写入看起来像私钥、GitHub 令牌等敏感信息。

自动化功能由 Apple 基础模型本地免费运行：会话标题起草、提交消息生成、头像提示、技能导入摘要。每项自动化都有独立的模型选择器。

模型和提供者方面，自动发现配置的 Pi 提供者的模型。按提供者分组。可设置默认值、按代理和按会话覆盖。隐藏未使用的条目。环境视图管理 .env 文件，支持秘密遮蔽。

健康与设置方面，Doctor 运行健康检查，包括 Pi CLI、版本、路径解析和必需的环境密钥，并提供自动修复建议。包含 6 页欢迎导览和逐步设置向导。

文档涵盖系统提示逻辑、Pi RPC 启动标志、技能和模型参考、记忆设计、资源刷新和文件监视等。要求 macOS 26 (Tahoe)、Apple Silicon、Xcode 26.4+ 和 Pi CLI。许可证为 MIT。