Open iTerm2 from the Finder
AppleScript Python

iTerm2 Finder Tools

New home for the code from my my blogpost about opening iTerm2 directly from the Finder. Read the release post here.

What is it?

A Finder service and toolbar application that will open iTerm2 and cd to the current directory visible in the Finder.


  • Works regardless if iTerm2 is running or not – will start it if necessary.
  • Creates a new tab in the current open window for this directory.
  • Creates a new window if none are already open.
  • Yeah, this is pretty simple, isn't it?

Version support

This repository includes a pre-built Finder service and a pre-built application; these work with "modern" iTerm2 (version 2.9+). If you're using an older version of iTerm2, you'll have to run the build scripts to get a version that works for you. See the instructions below.


First, either download the repository with the big green button in the upper right or clone the repository like this:

$ git clone
Finder Service

Double click Open iTerm.workflow and click "Install"

service installation dialog

You can add a keyboard shortcut for this service by going to System Preferences > Keyboard > Shortcuts > Services > Files and Folders.

keyboard shortcut

Unfortunately, it seems that this keyboard shortcut will only work if iTerm2 is already running.

Finder Menu Tool

You can move the built Open anywhere you'd like, or leave it here; add it to your Finder toolbar by dragging it in while holding the command and option keys.

toolbar app install


Build the application and Finder service like this:

$ python

The build script will detect which version of iTerm2 you have installed and automatically use the right applescript -- *.modern.applescript for version 2.9+, and *.applescript for older versions.

The build script should work with both Python 2 and Python 3.