中文文档

Quickly open a terminal from the current Finder directory.

• One-click launch — Open a terminal right from the Finder toolbar
• Smart detection — Automatically detects installed terminal apps
• Native icons — Displays each terminal's real app icon
• Pure Swift, lightweight and fast
• Simple to use, no complex configuration needed

The app auto-detects the following terminals. Uninstalled ones are greyed out:

• Terminal.app (built-in)
• iTerm2
• Warp
• Ghostty
• WezTerm
• Kitty
• Alacritty

If the preferred terminal is uninstalled, it automatically falls back to the built-in Terminal.app.

# Trust the cask (one-time; needed on Homebrew ≥ 5.1.15, skip on older versions)
brew trust --cask solarhell/tap/solarhell-go2shell

# Install
brew install solarhell/tap/solarhell-go2shell

# Upgrade
brew upgrade solarhell/tap/solarhell-go2shell

Upgrading from an older install? The cask was renamed from go2shell to solarhell-go2shell to avoid a name collision with the unrelated go2shell cask in homebrew/cask. Trust entries are stored per token and are not carried over by the rename, so trust the new token first, then migrate:

brew trust --cask solarhell/tap/solarhell-go2shell
brew migrate --cask solarhell/tap/go2shell

make install

# Then drag go2shell.app from /Applications to the Finder toolbar
# (hold ⌘ while dragging)

# Done! Click the toolbar icon to open a terminal in the current directory.

Note: The app is not notarized. macOS Gatekeeper may block it on first launch. To bypass:

xattr -d com.apple.quarantine /Applications/go2shell.app

Or go to System Settings > Privacy & Security and click "Open Anyway".

1. Open the Applications folder
2. Hold ⌘ (Command)
3. Drag go2shell.app onto any Finder window's toolbar
4. Done!

• Click the go2shell icon in any Finder window's toolbar
• A terminal opens at the current directory automatically

Option 1: Hold Option key

• Hold Option (⌥) and click go2shell in the Finder toolbar
• Or hold Option and double-click the app icon in Finder
• Select your preferred terminal in the settings UI

Option 2: Command line

open /Applications/go2shell.app --args --show-ui

Option 3: Defaults

# Set to Terminal.app (default)
defaults write com.solarhell.go2shell PreferredTerminal Terminal

# Set to iTerm2
defaults write com.solarhell.go2shell PreferredTerminal iTerm

# Set to Warp / Ghostty / WezTerm / Kitty / Alacritty
defaults write com.solarhell.go2shell PreferredTerminal Warp
defaults write com.solarhell.go2shell PreferredTerminal Ghostty
defaults write com.solarhell.go2shell PreferredTerminal WezTerm
defaults write com.solarhell.go2shell PreferredTerminal Kitty
defaults write com.solarhell.go2shell PreferredTerminal Alacritty

• macOS Sequoia 15.0+
• Xcode 16+ (for building)

Built with Swift Package Manager and Makefile.

make help      # Show all commands
make build     # Build the app
make install   # Install to /Applications
make clean     # Clean build files
make debug     # Show debug info

swift build -c release
.build/release/go2shell

Note: SPM alone only compiles the binary. Use make build to create a full App Bundle.

1. Uses Apple Events (AppleScript) to get the frontmost Finder window's path
2. Falls back to the Desktop path if no Finder window is open
3. Opens the preferred terminal at that path via AppleScript
4. Exits automatically after launching the terminal

go2shell/
├── Package.swift              # SPM configuration
├── Makefile                   # Build automation
├── Sources/
│   ├── main.swift             # Entry point
│   ├── Views.swift            # SwiftUI interface
│   ├── TerminalManager.swift  # Terminal launch logic
│   ├── Terminal.swift         # Terminal.app ScriptingBridge
│   ├── Finder.swift           # Finder ScriptingBridge
│   └── FinderManager.swift    # Finder path retrieval
├── Resources/
│   ├── Info.plist             # App configuration
│   ├── go2shell.entitlements  # App entitlements
│   └── AppIcon.icns           # App icon
└── .build/                    # Build output (generated)

• Support Terminal.app, iTerm2, Warp, Ghostty, WezTerm, Kitty, Alacritty
• Native app icons
• Grey out uninstalled terminals, auto-fallback on uninstall
• Open in new tab or new window
• Keyboard shortcuts
• Custom terminal commands (e.g., run a script after cd)

MIT