摘要：本文介绍 GroAsk，一个 macOS 菜单栏 AI 启动器，通过全局快捷键 ⌥Space 实现 Claude Code 等 CLI AI 工具的一键启动和图形化安装。文章详细记录了 Terminal.app、iTerm2、Ghostty、Warp 四种终端的自动化实现差异，以及 PATH 检测、依赖链安装等技术细节。
背景：重复动作的时间成本
我是 Claude Code 的重度用户，每天在不同项目间切换约 30 次。每次启动的流程是：
cd ~/Projects/my-app
claude "fix the login bug"
4 步操作 × 30 次 × 20 秒 = 每天 10 分钟，一年 60 小时。这个时间成本够写一个新项目了。
除了时间，还有三个附加痛点：
- 终端碎片化：不是所有人都用 Terminal.app，iTerm2、Ghostty、Warp 各有用户群，但大多数工具只支持默认终端
- 安装折腾：CLI 工具的 PATH 配置、版本管理器选择、依赖链处理，每一步都可能卡住
- 门槛问题：
cd和命令行对非开发者是真实的障碍
基于这些痛点，我做了 GroAsk。
核心功能：⌥Space 一键启动
传统方式（4 步）：打开终端 → cd ~/Projects/my-app → claude "fix the login bug" → 等GroAsk（1 步）：⌥Space → 输入 "fix the login bug" → 回车
按下 ⌥Space（可自定义），弹出类似 Spotlight 的输入框。选 Claude Code 通道，写 prompt，回车。终端自动打开并 cd 到正确目录，带着 prompt 启动 Agent。
关键区别：终端打开的那一刻，Claude Code 已经带着你的指令在工作了，不是打开终端让你手动输入。
工作目录来源
三级优先级：
- Finder 联动 — 读取当前 Finder 窗口目录
- 别名 —
/app fix bug展开为cd ~/Projects/my-app && claude "fix bug" - 默认目录 — 兜底路径
四种终端的自动化实现
这是整个项目技术含量最高的部分。四种终端的自动化能力差异非常大，不存在统一的抽象层。
Terminal.app — AppleScript do script
tell application "Terminal"activatedo script "cd ~/Projects/my-app && claude \"fix the login bug\""
end tell
Terminal.app 的 AppleScript 字典完整，可以精确控制窗口创建、Tab 管理、命令执行。是四种实现中最稳定的。
iTerm2 — AppleScript create window with profile
tell application "iTerm"activatecreate window with profile "Default" command "cd ~/Projects/my-app && claude \"fix\""
end tell
iTerm2 的 AppleScript API 比 Terminal.app 更现代，支持 Profile 指定终端配置。使用体验和 Terminal.app 一样顺滑。
Ghostty — -e 参数 + login shell
Ghostty（Mitchell Hashimoto 开发的新终端）没有 AppleScript 支持，但提供 -e 参数：
open -na Ghostty --args -e bash -l -c 'cd ~/Projects/my-app && claude "fix"'
踩坑记录：
-e 是替换 shell 而不是在 shell 里执行命令。这意味着：
.zshrc/.bashrc不会被加载- PATH 是残缺的
claude命令大概率command not found
解法是用 bash -l -c 包一层，-l 保证加载完整的 shell profile。这个问题在 Ghostty 用户社区里被反复问到。
Warp — YAML Launch Configuration + URI scheme
Warp 是最棘手的。它没有 AppleScript 支持，也没有 -e 参数，没有任何可编程接口。
唯一的自动化路径是 Launch Configuration 机制：
步骤 1：动态生成 YAML 配置文件
# ~/.warp/launch_configurations/groask_session.yaml
---
name: groask_session
windows:- tabs:- layout:cwd: ~/Projects/my-appcommand: claude "fix the login bug"
步骤 2：通过 URI scheme 触发
open "warp://action/launch?config=groask_session"
GroAsk 每次启动时动态生成 YAML 文件写入 Warp 配置目录，然后触发 URI scheme。虽然多了文件 I/O，但用户体验和其他终端一致。
实现对比
| 维度 | Terminal.app | iTerm2 | Ghostty | Warp |
|---|---|---|---|---|
| 自动化方式 | AppleScript | AppleScript | -e 参数 |
YAML + URI |
| 窗口控制 | 完整 | 完整 | 无 | 无 |
| shell 环境 | 自动加载 | 自动加载 | 需手动包装 | 自动 |
| 实现复杂度 | 低 | 低 | 中 | 高 |
一键安装 CLI 工具
依赖链自动处理
不同 CLI 工具的安装方式差异大。GroAsk 做了统一的图形化安装，点一下自动处理完整依赖链：
有 curl 安装器的工具（Claude Code、Kimi Code）：
curl -fsSL https://cli.example.com/install.sh | bash
# 自动追加 PATH 到 .zshrc
依赖 npm 的工具（Gemini CLI、Codex）：
检测 npm ──有──→ 直接 npm install -g└无──→ 检测 fnm ──有──→ fnm install --lts → 装 CLI└无──→ 装 fnm → 装 Node.js → 装 CLI
全程不需要 sudo、Homebrew、Xcode Command Line Tools。
安装状态轮询
安装触发后，后台每 2 秒检测：
bash -l -c 'command -v claude'
用 bash -l 加载完整 shell 环境，确保能发现新安装的工具。3 分钟超时保护。
PATH 检测方案
macOS GUI 应用启动时不加载 .zshrc，PATH 和终端不一样。GroAsk 的方案：
bash -l -c 'printf MARKER%s "$PATH"'
MARKER 前缀用于隔离 conda、pyenv 等工具在 shell 初始化时输出到 stdout 的噪声文本。再加上文件系统扫描——~/.local/bin、~/.cargo/bin、各种版本管理器路径——兜底覆盖所有安装方式。
多 AI 统一入口
同一个 ⌥Space 输入框，Tab 切换 10 个 AI：
- CLI AI（6 个）：Claude Code、Gemini CLI、Codex、CodeBuddy、Kimi Code、Qwen Code
- Web AI（4 个）：ChatGPT、Claude、Gemini、Monica
Web AI 会自动打开浏览器页面并注入 prompt 到输入框，不需要手动复制粘贴。
还有划词即问功能：选中文本 → 快捷键 → 自动填入 → 发给 AI。
项目数据
- 190 次 git 提交，49% 由 Claude Code 协作
- 14 天从零到上线
- 5,600 行 Swift（纯 AppKit）+ 1,200 行 Server（Cloudflare Workers）
- 内存 < 30MB
- 免费，100% 本地桥接，不存储数据
下载：groask.com
GitHub：github.com/ThinkerJack/groask-release
觉得有用请 Star，反馈到 GitHub Discussions。