Quicksilver Manual > Plug-ins > iTerm plug-in

About

The plug-in enables shell commands to be executed through iTerm.

Usage and Detailed Documentation

After the plug-in has been installed, you may choose to set iTerm as the default command line interface in the Handlers preference pane via Quicksilver's preferences. If iTerm is set as the default command line interface, the actions used by Terminal plug-in that results in shell commands being displayed by Terminal will be replaced by iTerm instead.

The plug-in also provides iTerm-specific version of the actions used by the Terminal plug-in:

  • Go to Directory in Iterm Go to the specified directory in iTerm.
    1. Invoke Quicksilver
    2. Select a folder as the direct object in the first pane
    3. Set the action to Go to Directory in iTerm in the second pane
    4. Press enter/return to execute the action

  • Run a Text Command in iTerm Executes a text command in iTerm
    1. Invoke Quicksilver
    2. Type in a command via text mode as the direct object in the first pane
    3. Set the action to Run a Text Command in iTerm in the second pane
    4. Press enter/return to execute the action

  • Run in iTerm […] Run a shell script in iTerm.
    1. Invoke Quicksilver
    2. Select a script as the direct object in the first pane
    3. Set the action to Run in iTerm […] in the second pane
      1. (Optional) Type in any additional arguments to the script via text mode as the indirect object in the third pane
    4. Press enter/return to execute the action

  • Show Man Page Show the man page for the specified command. You must add /usr/bin/ to the catalog first before you can use this action. See the notes from the Terminal plug-in for additional instructions.
    1. Invoke Quicksilver
    2. Select a shell command as the direct object in the first pane
    3. Set the action to Show Man Page in the second pane
    4. Press enter/return to execute the action

Requirements

Known Issues

  • Escaping of arguments may be iffy.
  • If iTerm is running but there are no windows, iTerm actions may not work.
  • Execution of a command in the first tab in iTerm is not supported yet.
  • The iTerm version of Show Man Page behaves a little differently than the corresponding Terminal action – exiting the man command does not end the shell session.
  • Refer to the forum thread for more details.

Credits

  • Written by ytrewq1

Acknowledgments

  • David Phillip Oster (osasubr)
  • Adam Ratcliffe