Kooky
为 AI 编程打造的极简现代终端：侧栏工作区、分屏窗格、一键启动代理、实时活动状态与 Node/分支一键切换。
- Star 数
- ★ 654
- 最近更新
- 11 天前
- License
- MIT
- 主语言
- Swift
- FA 评分
- 47/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 平台专用Codex · Claude Code
- 费用
- 免费，无需付费服务
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 同时在多个项目中并行运行 Claude Code 或 Codex 的开发者：侧栏工作区 + 分屏窗格让每个项目独立管理，代理面板按'谁在等你'排序统一查看。
- 不适合
- 只使用 Linux 或 Windows 的用户——仅支持 macOS 14+
- 不愿处理 Gatekeeper 拦截和临时签名安装的用户
- 需要 Apple Developer ID 签名或公证分发的企业环境
- 源码审查
- 47/100 · 缺口较多
这个 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？
从 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 有哪些优点和局限？
- 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 与同类方案有什么区别？
README 多次提及 Ghostty（kooky 使用其 libghostty 引擎渲染，并继承了 ghostty.app 的 zsh 点击定位光标交互），定位是'在 Ghostty 引擎之上叠加 AI 代理工作流'的终端，而非通用终端模拟器。
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| Kooky 当前 | 47 · 缺口较多 | 桌面应用免费 | ★ 654 | 11 天前 | Swift | Codex · Claude Code |
| zerostack | 57 · 缺口较多 | 命令行工具免费 + 模型费 | ★ 1.7k | 1 天前 | Rust | OpenAI API · Claude API |
| agterm | 75 · 表现良好 | 桌面应用免费 | ★ 693 | 今天 | Swift | Codex · Claude Code |
| tty7 终端工作台 | 67 · 存在缺口 | 桌面应用免费 | ★ 1.3k | 1 天前 | Rust | — |
FollowAgents 如何评估这个 Agent？
查看各维度的扣分理由
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的权限边界。
最近版本
来自该项目 GitHub Releases 的最新发布记录，说明为上游原文摘录，未经本站改写或测试。
-
发布说明摘录
- New: keyboard shortcuts that match Ghostty, Warp and cmux. ⌥⌘ + arrow moves focus to the split in that direction, ⌃⌘ + arrow moves the nearest divider, and ⌘Home / ⌘End / ⌘Page Up / ⌘Page Down scroll the terminal to the top, to the bottom, or by a page — following your Ghostty config if you've rebound them. - New: ⌃⌘[ / ⌃⌘] step to the previous / next workspace, wrapping at the ends. The sidebar scrolls to the workspace you land on and unfolds its group if it was collapsed. Thanks @kaijianding for the idea and a draft implementation. (#84) …在 GitHub 查看 ↗ -
发布说明摘录
- Fixed: switching Node versions or Git branches, or unsetting proxy variables from the status bar preserves unfinished shell input and the cursor position, even when you keep typing during the switch. Actions run in the current zsh, bash, or fish session without mixing commands with your input or executing unfinished text. Proxy unsetting clears both lowercase and uppercase variables, supports fish, and leaves other terminals' settings alone. …在 GitHub 查看 ↗ -
发布说明摘录
- Changed: closing the last window no longer quits kooky. The window is hidden with its terminals and agents still running, the app stays in the Dock like Terminal and iTerm do, and clicking its icon brings the same window back exactly as you left it. ⌘Q still quits.在 GitHub 查看 ↗
常见问题
需要付费或有账号吗？
首次启动被拦截怎么办？
xattr -d com.apple.quarantine /Applications/Kooky.app 绕过；macOS 只拦截首次。