iTerm-Split-Automator

Automate the running of commands in split iTerm sessions

Installation

From the iTerm2 menu, click: Scripts->Manage->Import... then navigate to the launcher.zip file

Configuration

The configuration yaml file must define two entries:

layout: |
    space_separated names of
    split_panes

commands:
    - panes: <regex_matching_pane_names>
      cmd: cmd to run 1

    - panes: <regex_matching_pane_names>
      cmd: cmd to run 2

In addition, layouts may define an additional variables section, which contains elements which will later be substituted into commands with pythons .format() method.

Variables that begin with !password prompt the user for a password on each run.

Variables that begin with !prompt prompt the user for plain-text input on each run.

The following configuration file:

variables:
    to_echo: "things to echo"
    my_password: !password enter password
    my_prompt: !prompt enter prompt

layout: |
    row1_A row1_B
    CC D EEE
    last_row

commands:
    # Clear all terminals and change to test_dir/
    - panes: .*
      cmd: clear && cd test_dir/

    - sleep: 1

    # Top row executes `ls`
    - panes: row1_.*
      cmd: ls

    # Write to file from two panes, separated by 1 second
    - panes: (CC)|(EEE)
      cmd: echo "{name} Wrote me to a file" >> test_file
      sleep: 1

    - panes: D
      cmd: cat test_file

    # Echo the variables defined above
    - panes: last_row
      cmd: 'echo {to_echo} : {my_prompt}, {my_password}'

Creates the following terminal: