anyGoShell

中文文档 | English

极简 macOS 工具，从 Finder 工具栏一键打开终端。

---

简介

anyGoShell 是 Finder 与终端之间的无缝桥梁。只需点击 Finder 工具栏图标，即可在当前目录立即打开终端会话 —— 无需手动导航。

• 专为开发者、高级用户以及频繁在文件浏览与命令行操作之间切换的人群设计。
• 一键打开 - Finder 工具栏点击，终端立刻在当前目录启动
• 任意终端 - Terminal、iTerm2、Warp、Ghostty、CMUX、WezTerm... 支持所有主流终端
• 自定义终端 - 有新终端？直接输入名字就能用
• 纯 Swift - 2MB，无后台进程，点击即用即走

功能特性

特性	说明
工具栏集成	通过拖放添加到 Finder 工具栏（⌘ + 拖动）
智能检测	自动检测已安装的终端，隐藏不可用的选项
原生图标	显示终端应用的实际图标，视觉识别更直观
自定义终端	支持通过名称输入任意终端应用
回退机制	首选终端不可用时自动使用 Terminal.app
轻量高效	纯 Swift 实现，资源占用极低

理论支持所有终端

• Terminal.app — macOS 内置终端
• iTerm2 — 广受欢迎的第三方终端
• Warp — 现代 AI 驱动终端
• Ghostty — 高性能终端模拟器
• WezTerm — 跨平台终端复用器
• 任意自定义终端 — 直接输入应用名称
• 所有的你本地的终端 只需要把名字填对

---

安装

从 release 中手动下载（推荐）

---

快速开始

步骤一：添加到 Finder 工具栏

1. 打开 /Applications 文件夹
2. 按住 ⌘ (Command) 键
3. 将 anyGoShell.app 拖动到任意 Finder 窗口的工具栏

步骤二：点击启动

点击工具栏图标 —— 终端即刻在当前目录打开。

---

配置

图形界面设置

双击 /Applications 中的应用图标打开设置面板。

命令行配置

# Terminal.app（默认）
defaults write com.solarhell.anyGoShell PreferredTerminal Terminal

# iTerm2
defaults write com.solarhell.anyGoShell PreferredTerminal iTerm

# Warp / Ghostty / WezTerm
defaults write com.solarhell.anyGoShell PreferredTerminal Warp
defaults write com.solarhell.anyGoShell PreferredTerminal Ghostty
defaults write com.solarhell.anyGoShell PreferredTerminal WezTerm

# 自定义终端
defaults write com.solarhell.anyGoShell UseCustomTerminal -bool true
defaults write com.solarhell.anyGoShell CustomTerminalName "Alacritty"

---

系统要求

• macOS Sequoia 15.0+
• Xcode 16+（用于构建）

---

技术实现

anyGoShell 使用 Apple Events (AppleScript) 实现：

1. 查询最前端 Finder 窗口的当前路径
2. 若无 Finder 窗口则回退至桌面路径
3. 通过 AppleScript API 调用首选终端
4. 终端启动后自动退出应用

---

参与贡献

欢迎提交 Issue 或 Pull Request：GitHub

详见 CONTRIBUTING.md

---

许可证

本项目采用 MIT License 开源协议。

---

致谢

部分代码移植自 OpenInTerminal，感谢原作者的贡献。

---

相关链接

• 代码仓库: github.com/tom-hanks/anyGoShell
• 问题反馈: 提交 Issue