Kooky
为 AI 编程打造的极简现代终端：侧栏工作区、分屏窗格、一键启动代理、实时活动状态与 Node/分支一键切换。
README声明了多项安全行为：粘贴多行可疑命令需确认、OSC 52剪贴板写入需批准、sudo/ssh输入时启用安全键盘输入、无遥测、kooky://深链不携带命令、CLI仅经本地owner-only socket。但提供的证据只有README与LICENSE，无任何源代码佐证，均为无支持的断言，故各项仅给1分。least_privilege：SSH会话、CLI可开关标签页等能力面较宽，未见权限设计的代码证据。rollback：状态持久化与会话恢复有描述，但更新/回滚路径未说明。source_attribution：引用NOTICE.md与上游主题许可，但文件本身未提供。
CLI的失败信息文档化最好：'any failure prints one reason line on stderr'，status命令exit 1表示未运行，故failure_messages给2。self_consistency：README内部叙述连贯，但'1000+ unit tests'等声明无法在证据内核实，扣分。dependency_availability：依赖Xcode 26+、libghostty xcframework（setup脚本），脚本存在性不可验证。
受众明确（AI编码终端，macOS 14+），shell兼容性（zsh/bash/fish）与多代理支持描述具体，environment_fit与audience给2。capability_boundaries：表格明确标注各代理不支持的能力（如Grok无waiting dot），给2。trigger_precision：'Ask agent'右键、⌘P等触发行为仅文字描述，无法核实实现精度。
license给满分：LICENSE全文为MIT，README另有NOTICE.md与徽章。install_notes给2：Gatekeeper绕过三条路径详尽且如实标注adhoc签名风险。examples给2：CLI命令示例完整。information_architecture与naming_stability给2。known_limitations仅1：零散提及部分代理缺信号、SSH历史仅本地，但无系统性限制章节。versioning_changelog给1：引用CHANGELOG.md但未提供内容。maintenance_responsibility给1：单作者、发布者身份未验证，无维护承诺说明。
output_usability给2：CLI输出JSON、状态栏、通知中心等设计对可用性描述充分。marginal_value给2：相对普通终端的代理集成（一键启动、会话恢复、活动读出）有明确差异化价值。cost_benefit仅1：无代码与测试证据支持其宣称的规模，收益判断依赖不可核实的声明。
claim_traceability给1：大量具体声明（十五个代理、1000+测试、40+主题）无源文件可追溯。cross_source_corroboration给1：中文/日文README、CHANGELOG、NOTICE均被引用但不在证据内。fact_inference_separation给2：README将'能做什么'与'如何配置'区分较清楚，未混入大量主观推销性判断。
- 本次评审仅基于README与LICENSE，未提供任何源代码、测试或CHANGELOG，所有安全与可靠性声明（粘贴确认、OSC 52审批、owner-only socket、1000+测试）均未经代码核实。
- 应用为adhoc签名，首次启动需绕过Gatekeeper；README的Path C会全局关闭Gatekeeper，属系统级风险，仅在必要时使用并尽快恢复。
- 发布者身份未经验证；下载预编译dmg前请确认二进制来源，企业环境应自行审计或从源码构建。
- kooky-cli可从脚本开关/关闭标签页并启动代理会话，部署前应评估本机socket的权限边界。
这个 Agent 能做什么，适合哪些场景？
Kooky 是一款 macOS 原生（SwiftUI 编写）的终端应用，专为运行 AI 编程代理而设计，基于 libghostty 引擎实现 GPU 加速渲染。它内置侧栏工作区、水平/垂直分屏、一键启动 15 种 AI 代理（如 Claude Code、Codex、Gemini CLI），并提供等待状态圆点、工具调用胶囊和代理活动实时读数。支持跨重启恢复全部 15 种内置代理的会话，代理面板可按状态排序并汇总所有窗口中的代理。还提供 Git worktree 创建、远程 SSH 工作区、文件树侧栏、提示词编辑器（⌘L）、Quick Open（⌘P）和本地 CLI 工具 kooky-cli。应用无账号、无遥测，状态全部保存在本地，采用 MIT 许可证开源。
Kooky 将文件夹打开为工作区，每个工作区可分屏为多个窗格，每个窗格有独立的标签页和会话。用户通过 '+' 菜单一键启动 15 种 AI 代理 CLI（claude、codex、gemini、opencode、amp、cursor-agent、copilot、grok、agy、kimi、pi、omp、reasonix、kiro-cli、droid），也可在 Settings → Agents 中添加自定义代理（支持上传 logo、设置环境变量、基于内置代理模板）。侧栏圆点实时显示代理状态（运行中蓝色/等待你琥珀色/空闲无色），窗格状态栏显示正在运行的工具、git 仓库/分支/diff、Python venv、Node 版本和代理设置，点击 Node 或分支胶囊即可切换。支持右键 git 工作区创建 worktree、⌘P 创建 SSH 工作区（代理在远程启动）、选中文字右键 'Ask <agent>' 直接提交提示词、⌘L 打开多行提示词编辑器、代理面板浏览并恢复历史会话、Session Info 页面查看进程树/端口/退出码并一键 'Ask AI'。kooky-cli 可从脚本打开标签、恢复会话、列出/聚焦/关闭标签页。
- 同时在多个项目中并行运行 Claude Code 或 Codex 的开发者：侧栏工作区 + 分屏窗格让每个项目独立管理，代理面板按'谁在等你'排序统一查看。
- 需要切换 Node 版本或 git 分支的前端工程师：状态栏胶囊一键切换，无需手动输入命令。
- 想在功能分支上让 Claude 干活而不影响 main 分克运行状态的开发者：右键工作区 → Create Worktree… 一键创建嵌套 worktree。
- 需要远程开发（nvm 安装的工具、远程 shell 环境）的工程师：SSH 工作区让代理在远程机器上启动，本地粘贴的文件自动上传。
- 脚本化控制终端的自动化用户：kooky-cli open/resume/list/focus/close 命令可从其他本地应用驱动 Kooky。
- 经常粘贴网页命令的用户：多行内容粘贴需确认，防止 curl … | sh 类陷阱命令误执行。
这个 Agent 有哪些优点和局限？
- 15 种主流 AI 编程代理 CLI 原生集成，一键启动且全部支持跨重启会话恢复（使用各 CLI 的精确 session ID）。
- 基于 libghostty 的 GPU 加速渲染，120Hz/ProMotion 屏幕滚动流畅；SwiftUI 原生界面，支持完整 IME。
- 等待/失败/运行状态实时可视化（侧栏圆点、工具胶囊、通知中心、菜单栏图标），未聚焦标签的等待会发 macOS 通知。
- SSH 工作区让代理在远程启动并加载远程 shell 配置，本地文件/截图粘贴自动上传为远程可读路径。
- Keep-awake 三档管理：代理工作或 SSH 会话期间 Mac 不会休眠（含合盖），工作结束自动恢复。
- 仅支持 macOS 14+，无 Linux/Windows 版本。
- ad hoc 签名导致首次启动需手动绕过 Gatekeeper，尚无 Apple Developer ID 公共分发签名和公证。
- 从源码构建需 Xcode 26+，libghostty 需额外脚本拉取 xcframework，构建门槛较高。
- 等待状态圆点对部分代理（Grok Build、Kiro CLI）不可用，因其不暴露信号；工具胶囊也非所有代理支持。
- 部分高级功能（如安全键盘输入、Keep-awake 合盖唤醒）依赖 macOS 系统权限，需一次性管理员授权。
如何安装或部署这个 Agent？
从 GitHub Releases 下载最新 .dmg 并拖入 Applications。因 adhoc 签名，首次启动会被 Gatekeeper 拦截：路径 A — System Settings → Privacy & Security → Security → Open Anyway；路径 B — 终端执行 xattr -d com.apple.quarantine /Applications/Kooky.app。从源码构建需 Xcode 26+ 和 macOS 14+：./scripts/setup-libghostty.sh（一次性获取 libghostty xcframework）→ swift build → ./scripts/build-app.sh 或 ./scripts/build-dmg.sh --build。
如何使用这个 Agent？
打开 Kooky 后，⌘O 或从 Finder 拖入文件夹创建工作区；点击 '+' 菜单选择代理（如 Claude Code）一键启动会话；⌘D / ⌘⇧D 分屏；⌘P 打开 Quick Open 或创建 SSH 工作区；⌘L 打开提示词编辑器编写多行提示词；右键工作区可创建 worktree、设置颜色标签；代理面板（右侧栏）查看/跳转所有代理并浏览历史会话；选中错误信息右键 'Ask <agent>' 直接提交给代理。CLI 示例：kooky-cli open --cwd ~/Github/vibex -e "npx @deepseek-ai/dsh web"、kooky-cli resume --agent codex --id <conversation-id>、kooky-cli list --。
这个 Agent 与同类方案有什么区别？
README 多次提及 Ghostty（kooky 使用其 libghostty 引擎渲染，并继承了 ghostty.app 的 zsh 点击定位光标交互），定位是'在 Ghostty 引擎之上叠加 AI 代理工作流'的终端，而非通用终端模拟器。
常见问题
需要付费或有账号吗？
首次启动被拦截怎么办？
xattr -d com.apple.quarantine /Applications/Kooky.app 绕过；macOS 只拦截首次。