update

.iterm2/it2api

@@ -0,0 +1,727 @@
+#!/usr/bin/env python3
+
+import argparse
+import asyncio
+try:
+  import iterm2
+except ModuleNotFoundError:
+  print("The current version of Python doesn't have the 'iterm2' module installed. Please run:")
+  print("\n    $ python3 -m pip install iterm2\n")
+  exit()
+import logging
+import re
+import sys
+import traceback
+
+async def list_sessions(connection, args):
+  a = await iterm2.async_get_app(connection)
+  for w in a.terminal_windows:
+    for t in w.tabs:
+      sessions = t.sessions
+      for s in sessions:
+        print(s.pretty_str(), end='')
+  print("")
+  print("Buried sessions:")
+  for s in a.buried_sessions:
+    print(s.pretty_str(), end='')
+
+async def show_hierarchy(connection, args):
+  a = await iterm2.async_get_app(connection)
+  print(a.pretty_str())
+
+async def send_text(connection, args):
+  a = await iterm2.async_get_app(connection)
+  s = a.get_session_by_id(args.session)
+  await s.async_send_text(args.text)
+
+async def create_tab(connection, args):
+  a = await iterm2.async_get_app(connection)
+  if args.window is not None:
+    window_id = args.window
+    try:
+      window = next(window for window in a.terminal_windows if window.window_id == window_id)
+      tab = await window.async_create_tab(profile=args.profile, command=args.command, index=args.index)
+    except:
+      print("bad window id {}".format(window_id))
+      sys.exit(1)
+  else:
+    window = await iterm2.Window.async_create(connection, profile=args.profile, command=args.command)
+    if not window:
+        return
+    tab = window.tabs[0]
+  session = tab.sessions[0]
+  print(session.pretty_str())
+
+async def split_pane(connection, args):
+  a = await iterm2.async_get_app(connection)
+  s = a.get_session_by_id(args.session)
+  session = await s.async_split_pane(vertical=args.vertical, before=args.before, profile=args.profile)
+  print(session.pretty_str())
+
+async def get_buffer(connection, args):
+  a = await iterm2.async_get_app(connection)
+  s = a.get_session_by_id(args.session)
+  contents = await s.async_get_screen_contents()
+  for i in range(contents.number_of_lines):
+    line = contents.line(i)
+    print(line.string)
+
+async def get_prompt(connection, args):
+  a = await iterm2.async_get_app(connection)
+  s = a.get_session_by_id(args.session)
+  result = await iterm2.async_get_last_prompt(connection, s.session_id)
+  print("working_directory: \"{}\"".format(result.working_directory))
+  print("command: \"{}\"".format(result.command))
+
+def profile_property_type_map():
+  map = {
+      "allow_title_reporting":                       "bool",
+      "allow_title_setting":                         "bool",
+      "ambiguous_double_width":                      "bool",
+      "ansi_0_color":                                "color",
+      "ansi_10_color":                               "color",
+      "ansi_11_color":                               "color",
+      "ansi_12_color":                               "color",
+      "ansi_13_color":                               "color",
+      "ansi_14_color":                               "color",
+      "ansi_15_color":                               "color",
+      "ansi_1_color":                                "color",
+      "ansi_2_color":                                "color",
+      "ansi_3_color":                                "color",
+      "ansi_4_color":                                "color",
+      "ansi_5_color":                                "color",
+      "ansi_6_color":                                "color",
+      "ansi_7_color":                                "color",
+      "ansi_8_color":                                "color",
+      "ansi_9_color":                                "color",
+      "answerback_string":                           "str",
+      "application_keypad_allowed":                  "bool",
+      "ascii_anti_aliased":                          "bool",
+      "ascii_ligatures":                             "bool",
+      "background_color":                            "color",
+      "background_image_is_tiled":                   "bool",
+      "badge_color":                                 "color",
+      "badge_text":                                  "str",
+      "blend":                                       "float",
+      "blink_allowed":                               "bool",
+      "blinking_cursor":                             "bool",
+      "blur":                                        "float",
+      "blur_radius":                                 "float",
+      "bm_growl":                                    "bool",
+      "bold_color":                                  "color",
+      "character_encoding":                          "int",
+      "close_sessions_on_end":                       "bool",
+      "cursor_boost":                                "float",
+      "cursor_color":                                "color",
+      "cursor_guide_color":                          "color",
+      "cursor_text_color":                           "color",
+      "cursor_type":                                 "int",
+      "disable_printing":                            "bool",
+      "disable_smcup_rmcup":                         "bool",
+      "disable_window_resizing":                     "bool",
+      "flashing_bell":                               "bool",
+      "foreground_color":                            "color",
+      "horizontal_spacing":                          "float",
+      "idle_code":                                   "int",
+      "idle_period":                                 "float",
+      "link_color":                                  "color",
+      "minimum_contrast":                            "float",
+      "mouse_reporting":                             "bool",
+      "mouse_reporting_allow_mouse_wheel":           "bool",
+      "name":                                        "str",
+      "non_ascii_anti_aliased":                      "bool",
+      "non_ascii_ligatures":                         "bool",
+      "only_the_default_bg_color_uses_transparency": "bool",
+      "left_option_key_sends":                       "int",
+      "place_prompt_at_first_column":                "bool",
+      "prompt_before_closing":                       "bool",
+      "reduce_flicker":                              "bool",
+      "right_option_key_sends":                      "int",
+      "scrollback_in_alternate_screen":              "bool",
+      "scrollback_lines":                            "int",
+      "scrollback_with_status_bar":                  "bool",
+      "selected_text_color":                         "color",
+      "selection_color":                             "color",
+      "send_bell_alert":                             "bool",
+      "send_code_when_idle":                         "bool",
+      "send_idle_alert":                             "bool",
+      "send_new_output_alert":                       "bool",
+      "send_session_ended_alert":                    "bool",
+      "send_terminal_generated_alerts":              "bool",
+      "session_close_undo_timeout":                  "float",
+      "show_mark_indicators":                        "bool",
+      "silence_bell":                                "bool",
+      "smart_cursor_color":                          "color",
+      "smart_cursor_color":                          "color",
+      "sync_title":                                  "str",
+      "tab_color":                                   "color",
+      "thin_strokes":                                "int",
+      "transparency":                                "float",
+      "underline_color":                             "color",
+      "unicode_normalization":                       "int",
+      "unicode_version":                             "int",
+      "unlimited_scrollback":                        "bool",
+      "use_bold_font":                               "bool",
+      "use_bright_bold":                             "bool",
+      "use_cursor_guide":                            "bool",
+      "use_italic_font":                             "bool",
+      "use_non_ascii_font":                          "bool",
+      "use_tab_color":                               "bool",
+      "use_underline_color":                         "bool",
+      "vertical_spacing":                            "float",
+      "visual_bell":                                 "bool",
+      "triggers":                                    "dict",
+      "smart_selection_rules":                       "list",
+      "semantic_history":                            "dict",
+      "automatic_profile_switching_rules":           "list",
+      "advanced_working_directory_window_setting":   "string",
+      "advanced_working_directory_window_directory": "string",
+      "advanced_working_directory_tab_setting":      "string",
+      "advanced_working_directory_tab_directory":    "string",
+      "advanced_working_directory_pane_setting":     "string",
+      "advanced_working_directory_pane_directory":   "string",
+      "normal_font":                                 "string",
+      "non_ascii_font":                              "string",
+      "background_image_location":                   "string",
+      "key_mappings":                                "dict",
+      "touchbar_mappings":                           "dict" }
+  return map
+
+def profile_properties():
+  return list(profile_property_type_map().keys())
+
+def profile_property_type(key):
+  return profile_property_type_map()[key]
+
+async def get_profile_property(connection, args):
+  a = await iterm2.async_get_app(connection)
+  s = a.get_session_by_id(args.session)
+  profile = await s.async_get_profile()
+  if args.keys is not None:
+    keys = args.keys.split(",")
+  else:
+    keys = profile_properties()
+  for prop in keys:
+    fname = prop
+    value = getattr(profile, fname)
+    print("{}: {}".format(prop, value))
+
+def encode_property_value(key, value):
+  type = profile_property_type(key)
+  if type == "bool":
+    assert value == "true" or value == "false"
+    return value == "true"
+  elif type == "str":
+    return value
+  elif type == "float":
+    return float(value)
+  elif type == "int":
+    return int(value)
+  elif type == "dict" or type == "list":
+    class TypeNotSupportedException(Exception): Pass
+    raise TypeNotSupportedException("this property's type is not supported")
+  elif type == "color":
+    # Accepted values look like: "(0,0,0,255 sRGB)"
+    regex = r"\(([0-9]+), *([0-9]+), *([0-9]+), *([0-9]+)  *([A-Za-z]+)\)"
+    match = re.search(regex, value)
+    assert match is not None
+    return iterm2.Color(
+        float(match.group(1)),
+        float(match.group(2)),
+        float(match.group(3)),
+        float(match.group(4)),
+        iterm2.ColorSpace(match.group(5)))
+
+async def set_profile_property(connection, args):
+  a = await iterm2.async_get_app(connection)
+  s = a.get_session_by_id(args.session)
+
+  encoded_value = encode_property_value(args.key, args.value)
+  profile = await s.async_get_profile()
+  fname = "async_set_" + args.key
+  f = getattr(profile, fname)
+  await f(encoded_value)
+
+async def read(connection, args):
+  a = await iterm2.async_get_app(connection)
+  s = a.get_session_by_id(args.session)
+  if args.mode == "char":
+    async with iterm2.KeystrokeMonitor(connection) as mon:
+      keystroke = await mon.async_get()
+      print(keystroke)
+  elif args.mode == "line":
+    async with s.get_keystroke_reader() as reader:
+      eol = False
+      line = ""
+      while not eol:
+        k = await reader.get()
+        for e in k:
+          c = e.characters
+          if c == "\r" or c == "\n":
+            eol = True
+            break
+          line += c
+
+      print(line)
+
+async def get_window_property(connection, args):
+  a = await iterm2.async_get_app(connection)
+  w = a.get_window_by_id(args.id)
+  if w is None:
+    print("bad window ID")
+  else:
+    if args.name == "frame":
+      frame = await w.async_get_frame()
+      print("{},{},{},{}".format(frame.origin.x,frame.origin.y,frame.size.width,frame.size.height))
+    elif args.name == "fullscreen":
+      print(await w.async_get_fullscreen(connection))
+
+async def set_window_property(connection, args):
+  a = await iterm2.async_get_app(connection)
+  w = a.get_window_by_id(args.id)
+  if w is None:
+    print("bad window ID")
+  else:
+    if args.name == "frame":
+      parts = args.value.split(",")
+      frame = iterm2.Frame(iterm2.Point(int(parts[0]), int(parts[1])), iterm2.Size(int(parts[2]), int(parts[3])))
+      await w.async_set_frame(frame)
+    elif args.name == "fullscreen":
+      await w.async_set_fullscreen(args.value == "true")
+
+async def inject(connection, args):
+  a = await iterm2.async_get_app(connection)
+  s = a.get_session_by_id(args.session)
+  if s is None:
+    print("bad session ID")
+  else:
+    await s.async_inject(args.data.encode())
+
+async def activate(connection, args):
+  a = await iterm2.async_get_app(connection)
+  if args.mode == "session":
+    s = a.get_session_by_id(args.id)
+    if s is None:
+      print("bad session ID")
+    else:
+      await s.async_activate()
+  elif args.mode == "tab":
+    t = a.get_tab_by_id(args.id)
+    if t is None:
+      print("bad tab ID")
+    else:
+      await t.async_select()
+  elif args.mode == "window":
+    w = a.get_window_by_id(args.id)
+    if w is None:
+      print("bad window ID")
+    else:
+      await w.async_activate()
+
+async def activate_app(connection, args):
+  a = await iterm2.async_get_app(connection)
+  await a.async_activate(raise_all_windows=args.raise_all_windows, ignoring_other_apps=args.ignoring_other_apps)
+
+async def set_variable(connection, args):
+  a = await iterm2.async_get_app(connection)
+  if args.session:
+    s = a.get_session_by_id(args.session)
+    if s is None:
+      print("bad session ID")
+      return
+    await s.async_set_variable(args.name, args.value)
+  elif args.tab:
+    t = a.get_tab_by_id(args.tab)
+    if t is None:
+      print("bad tab ID")
+      return
+    await t.async_set_variable(args.name, args.value)
+  else:
+    await a.async_set_variable(args.name, args.value)
+
+async def get_variable(connection, args):
+  a = await iterm2.async_get_app(connection)
+  if args.session:
+    s = a.get_session_by_id(args.session)
+    if s is None:
+      print("bad session ID")
+      return
+    value = await s.async_get_variable(args.name)
+    print(value)
+  elif args.tab:
+    t = a.get_tab_by_id(args.tab)
+    if t is None:
+      print("bad tab ID")
+      return
+    value = await t.async_get_variable(args.name)
+    print(value)
+  else:
+    value = await a.async_get_variable(args.name)
+    print(value)
+
+async def list_variables(connection, args):
+  a = await iterm2.async_get_app(connection)
+  if args.session:
+    s = a.get_session_by_id(args.session)
+    if s is None:
+      print("bad session ID")
+      return
+    value = await s.async_get_variable("*")
+    for name in value:
+      print(name)
+  elif args.tab:
+    t = a.get_tab_by_id(args.tab)
+    if t is None:
+      print("bad tab ID")
+      return
+    value = await t.async_get_variable("*")
+    for name in value:
+      print(name)
+  else:
+    value = await a.async_get_variable("*")
+    for name in value:
+      print(name)
+
+async def saved_arrangement(connection, args):
+  if args.window is not None:
+    a = await iterm2.async_get_app(connection)
+    w = a.get_window_by_id(args.window)
+    if w is None:
+      print("bad window ID")
+      return
+    if args.action == "save":
+      await w.async_save_window_as_arrangement(args.name)
+    elif args.action == "restore":
+      await w.async_restore_window_arrangement(args.name)
+  else:
+    if args.action == "save":
+      await iterm2.Arrangement.async_save(connection, args.name)
+    elif args.action == "restore":
+      await iterm2.Arrangement.async_restore(connection, args.name)
+
+async def show_focus(connection, args):
+  a = await iterm2.async_get_app(connection)
+  if a.app_active:
+    print("App is active")
+  w = a.current_terminal_window
+  print("Key window: {}".format(w.window_id))
+  print("")
+  for w in a.terminal_windows:
+    t = a.get_tab_by_id(w.selected_tab_id)
+    print("Selected tab in {}: {}".format(w.window_id, t.tab_id))
+    s = a.get_session_by_id(t.active_session_id)
+    print("  Active session is: {}".format(s.pretty_str()))
+
+async def list_profiles(connection, args):
+  guids = args.guids.split(",") if args.guids is not None else None
+  properties = args.properties.split(",") if args.properties is not None else None
+  profiles = await iterm2.PartialProfile.async_query(connection, guids=guids, properties=properties)
+  for profile in profiles:
+    keys = list(profile.all_properties.keys())
+    keys.sort()
+    for k in keys:
+      v = profile.all_properties[k]
+      print("{}: {}".format(k, v))
+    print("")
+
+async def set_grid_size(connection, args):
+  a = await iterm2.async_get_app(connection)
+  s = a.get_session_by_id(args.session)
+  await s.async_set_grid_size(iterm2.Size(args.width, args.height))
+
+async def list_tmux_connections(connection, args):
+  connections = await iterm2.async_get_tmux_connections(connection)
+  for connection in connections:
+    print("Connection ID: {}\nOwning session: {}".format(connection.connection_id, connection.owning_session))
+
+async def send_tmux_command(connection, args):
+  connections = await iterm2.async_get_tmux_connections(connection)
+  ids = []
+  for connection in connections:
+    if connection.connection_id == args.connection_id:
+      print(await connection.async_send_command(args.command))
+      return;
+    ids.append(connection.connection_id)
+  print("No connection with id {} found. Have: {}".format(args.connection_id, ", ".join(ids)))
+
+async def set_tmux_window_visible(connection, args):
+  connections = await iterm2.async_get_tmux_connections(connection)
+  ids = []
+  for connection in connections:
+    if connection.connection_id == args.connection_id:
+      await connection.async_set_tmux_window_visible(args.window_id, args.visible)
+      return;
+    ids.append(connection.connection_id)
+  print("No connection with id {} found. Have: {}".format(args.connection_id, ", ".join(ids)))
+
+async def sort_tabs(connection, args):
+  app = await iterm2.async_get_app(connection)
+  for w in app.terminal_windows:
+    tabs = w.tabs
+    for t in tabs:
+      t.tab_name = await t.async_get_variable("currentSession.session.name")
+    def tab_name(t):
+      return t.tab_name
+    sorted_tabs = sorted(tabs, key=tab_name)
+    await w.async_set_tabs(sorted_tabs)
+
+async def list_color_presets(connection, args):
+  presets = await iterm2.ColorPreset.async_get_list(connection)
+  for preset in presets:
+    print(preset)
+
+async def set_color_preset(connection, args):
+  preset = await iterm2.ColorPreset.async_get(connection, args.preset)
+  profiles = await iterm2.PartialProfile.async_query(connection, properties=['Guid', 'Name'])
+  for partial in profiles:
+    if partial.name == args.profile:
+      profile = await partial.async_get_full_profile()
+      await profile.async_set_color_preset(preset)
+
+async def monitor_variable(connection, args):
+  if args.session:
+    scope = iterm2.VariableScopes.SESSION
+    identifier = args.session
+  elif args.tab:
+    scope = iterm2.VariableScopes.TAB
+    identifier = args.tab
+  elif args.window:
+    scope = iterm2.VariableScopes.WINDOW
+    identifier = args.window
+  elif args.app:
+    scope = iterm2.VariableScopes.APP
+    identifier = ''
+  else:
+    assert False
+  async with iterm2.VariableMonitor(connection, scope, args.name, identifier) as monitor:
+    value = await monitor.async_get()
+    print(f"New value: {value}")
+
+async def monitor_focus(connection, args):
+    async with iterm2.FocusMonitor(connection) as monitor:
+        update = await monitor.async_get_next_update()
+        print("Update: {}".format(update))
+
+async def set_cursor_color(connection, args):
+    a = await iterm2.async_get_app(connection)
+    s = a.get_session_by_id(args.session)
+    partial = iterm2.LocalWriteOnlyProfile()
+    r, g, b = list(map(int, args.color.split(",")))
+    c = iterm2.Color(r, g, b)
+    partial.set_cursor_color(c)
+    await s.async_set_profile_properties(partial)
+
+async def monitor_screen(connection, args):
+    a = await iterm2.async_get_app(connection)
+    s = a.get_session_by_id(args.session)
+    async with s.get_screen_streamer() as streamer:
+        done = False
+        while not done:
+            contents = await streamer.async_get()
+            for i in range(contents.number_of_lines):
+                line = contents.line(i)
+                if args.query in line.string:
+                    return
+    
+async def show_selection(connection, args):
+    a = await iterm2.async_get_app(connection)
+    s = a.get_session_by_id(args.session)
+    selection = await s.async_get_selection()
+    for sub in selection.subSelections:
+        print("Sub selection: {}".format(await sub.async_get_string(connection, s.session_id)))
+    print("Text: {}".format(await selection.async_get_string(connection, s.session_id, s.grid_size.width)))
+
+def make_parser():
+  parser = argparse.ArgumentParser(description='iTerm2 CLI')
+  subparsers = parser.add_subparsers(help='Commands')
+
+  list_sessions_parser = subparsers.add_parser("list-sessions", help="List sessions")
+  list_sessions_parser.set_defaults(func=list_sessions)
+
+  show_hierarchy_parser = subparsers.add_parser("show-hierarchy", help="Show all windows, tabs, and sessions")
+  show_hierarchy_parser.set_defaults(func=show_hierarchy)
+
+  send_text_parser = subparsers.add_parser("send-text", help="Send text as though the user had typed it")
+  send_text_parser.add_argument('session', type=str, help='Session ID')
+  send_text_parser.add_argument("text", type=str, help='Text to send')
+  send_text_parser.set_defaults(func=send_text)
+
+  create_tab_parser = subparsers.add_parser("create-tab", help="Create a new tab or window")
+  create_tab_parser.add_argument('--profile', type=str, nargs='?', help='Profile name')
+  create_tab_parser.add_argument('--window', type=str, nargs='?', help='Window ID')
+  create_tab_parser.add_argument('--index', type=int, nargs='?', help='Desired tab index')
+  create_tab_parser.add_argument('--command', type=str, nargs='?', help='Command')
+  create_tab_parser.set_defaults(func=create_tab)
+
+  split_pane_parser = subparsers.add_parser("split-pane", help="Split a pane into two")
+  split_pane_parser.add_argument('session', type=str, help='Session ID')
+  split_pane_parser.add_argument('--vertical', action='store_true', help='Split vertically?', default=False)
+  split_pane_parser.add_argument('--before', action='store_true', help='Spilt left or above target', default=False)
+  split_pane_parser.add_argument('--profile', type=str, nargs='?', help='Profile name')
+  split_pane_parser.set_defaults(func=split_pane)
+
+  get_buffer_parser = subparsers.add_parser("get-buffer", help="Get screen contents")
+  get_buffer_parser.add_argument("session", type=str, help="Session ID")
+  get_buffer_parser.set_defaults(func=get_buffer)
+
+  get_prompt_parser = subparsers.add_parser("get-prompt", help="Get info about prompt, if available. Gives either the current prompt or the last prompt if a command is being run. Requires shell integration for prompt detection.")
+  get_prompt_parser.add_argument("session", type=str, help="Session ID")
+  get_prompt_parser.set_defaults(func=get_prompt)
+
+  get_profile_property_parser = subparsers.add_parser("get-profile-property", help="Get a session's profile settings")
+  get_profile_property_parser.add_argument("session", type=str, help="Session ID")
+  get_profile_property_parser.add_argument("keys", type=str, nargs='?', help="Comma separated keys. Omit to get all. Valid keys are: " + ", ".join(profile_properties()))
+  get_profile_property_parser.set_defaults(func=get_profile_property)
+
+  set_profile_parser = subparsers.add_parser("set-profile-property", help="Set a session's profile setting")
+  set_profile_parser.add_argument("session", type=str, help="Session ID")
+  set_profile_parser.add_argument("key", type=str, help="Key to set. Valid keys are: " + ", ".join(profile_properties()))
+  set_profile_parser.add_argument("value", type=str, help="New value.")
+  set_profile_parser.set_defaults(func=set_profile_property)
+
+  read_parser = subparsers.add_parser("read", help="Wait for a input.")
+  read_parser.add_argument("session", type=str, help="Session ID")
+  read_parser.add_argument("mode", type=str, help="What to read", choices=[ "char", "line" ])
+  read_parser.set_defaults(func=read)
+
+  get_window_property_parser = subparsers.add_parser("get-window-property", help="Get a property of a window")
+  get_window_property_parser.add_argument("id", type=str, help="Window ID")
+  get_window_property_parser.add_argument("name", type=str, help="Property name", choices=["frame", "fullscreen"])
+  get_window_property_parser.set_defaults(func=get_window_property)
+
+  set_window_property_parser = subparsers.add_parser("set-window-property", help="Set a property of a window")
+  set_window_property_parser.add_argument("id", type=str, help="Window ID")
+  set_window_property_parser.add_argument("name", type=str, help="Property name", choices=["frame", "fullscreen"])
+  set_window_property_parser.add_argument("value", type=str, help="New value. For frame: x,y,width,height; for fullscreen: true or false")
+  set_window_property_parser.set_defaults(func=set_window_property)
+
+  inject_parser = subparsers.add_parser("inject", help="Inject a string as though it were program output")
+  inject_parser.add_argument("session", type=str, help="Session ID")
+  inject_parser.add_argument("data", type=str, help="Data to inject")
+  inject_parser.set_defaults(func=inject)
+
+  activate_parser = subparsers.add_parser("activate", help="Activate a session, tab, or window.")
+  activate_parser.add_argument("mode", type=str, help="What kind of object to activate", choices=["session", "tab", "window"])
+  activate_parser.add_argument("id", type=str, help="ID of object to activate")
+  activate_parser.set_defaults(func=activate)
+
+  activate_app_parser = subparsers.add_parser("activate-app", help="Activate the app")
+  activate_app_parser.add_argument('--raise_all_windows', action='store_true', help='Raise all windows?', default=False)
+  activate_app_parser.add_argument('--ignoring_other_apps', action='store_true', help='Activate ignoring other apps (may steal focus)', default=False)
+  activate_app_parser.set_defaults(func=activate_app)
+
+  set_variable_parser = subparsers.add_parser("set-variable", help="Set a user-defined variable in a session. See Badges documentation for details.")
+  set_variable_parser.add_argument("--session", type=str, nargs='?', help="Session ID")
+  set_variable_parser.add_argument("--tab", type=str, nargs='?', help="Tab ID")
+  set_variable_parser.add_argument("name", type=str, help="Variable name. Starts with \"user.\"")
+  set_variable_parser.add_argument("value", type=str, help="New value")
+  set_variable_parser.set_defaults(func=set_variable)
+
+  get_variable_parser = subparsers.add_parser("get-variable", help="Get a variable in a session. See Badges documentation for details.")
+  get_variable_parser.add_argument("--session", type=str, nargs='?', help="Session ID")
+  get_variable_parser.add_argument("--tab", type=str, nargs='?', help="Tab ID")
+  get_variable_parser.add_argument("name", type=str, help="Variable name. Starts with \"user.\"")
+  get_variable_parser.set_defaults(func=get_variable)
+
+  list_variables_parser = subparsers.add_parser("list-variables", help="Lists variable names available in a session.")
+  list_variables_parser.add_argument("--session", type=str, nargs='?', help="Session ID")
+  list_variables_parser.add_argument("--tab", type=str, nargs='?', help="Tab ID")
+  list_variables_parser.set_defaults(func=list_variables)
+
+  saved_arrangement_parser = subparsers.add_parser("saved-arrangement", help="Saves and restores window arrangements")
+  saved_arrangement_parser.add_argument("action", type=str, help="Action to perform", choices=["save", "restore"])
+  saved_arrangement_parser.add_argument("name", type=str, help="Arrangement name")
+  saved_arrangement_parser.add_argument('--window', type=str, nargs='?', help='Window ID to save/restore to')
+  saved_arrangement_parser.set_defaults(func=saved_arrangement)
+
+  show_focus_parser = subparsers.add_parser("show-focus", help="Show active windows, tabs, and panes")
+  show_focus_parser.set_defaults(func=show_focus)
+
+  list_profiles_parser = subparsers.add_parser("list-profiles", help="List profiles")
+  list_profiles_parser.add_argument("--guids", type=str, nargs='?', help="Comma-delimited list of profiles to list. Omit to get all of them.")
+  list_profiles_parser.add_argument("--properties", type=str, nargs='?', help="Comma-delimited list of properties to request. Omit to get all of them.")
+  list_profiles_parser.set_defaults(func=list_profiles)
+
+  set_grid_size_parser = subparsers.add_parser("set-grid-size", help="Set size of session")
+  set_grid_size_parser.add_argument("session", type=str, help="Session ID")
+  set_grid_size_parser.add_argument("width", type=int, help="Width in columns")
+  set_grid_size_parser.add_argument("height", type=int, help="Height in rows")
+  set_grid_size_parser.set_defaults(func=set_grid_size)
+
+  list_tmux_connections_parser = subparsers.add_parser("list-tmux-connections", help="List tmux integration connections")
+  list_tmux_connections_parser.set_defaults(func=list_tmux_connections)
+
+  send_tmux_command_parser = subparsers.add_parser("send-tmux-command", help="Send a tmux command to a tmux integration connection")
+  send_tmux_command_parser.add_argument("connection_id", type=str, help="tmux connection ID")
+  send_tmux_command_parser.add_argument("command", type=str, help="Command to send")
+  send_tmux_command_parser.set_defaults(func=send_tmux_command)
+
+  set_tmux_window_visible_parser = subparsers.add_parser("set-tmux-window-visible", help="Show or hide a tmux integration window (represented as a tab in iTerm2)")
+  set_tmux_window_visible_parser.add_argument("connection_id", type=str, help="tmux connection ID")
+  set_tmux_window_visible_parser.add_argument("window_id", type=str, help="tmux window ID (number)")
+  set_tmux_window_visible_parser.add_argument('--visible', dest='visible', action='store_true')
+  set_tmux_window_visible_parser.add_argument('--no-visible', dest='visible', action='store_false')
+  set_tmux_window_visible_parser.set_defaults(visible=True)
+  set_tmux_window_visible_parser.set_defaults(func=set_tmux_window_visible)
+
+  sort_tabs_parser = subparsers.add_parser("sort-tabs", help="Sort tabs alphabetically by name")
+  sort_tabs_parser.set_defaults(func=sort_tabs)
+
+  list_color_presets_parser = subparsers.add_parser("list-color-presets", help="Lists names of color presets")
+  list_color_presets_parser.set_defaults(func=list_color_presets)
+
+  set_color_preset_parser = subparsers.add_parser("set-color-preset", help="Lists names of color presets")
+  set_color_preset_parser.add_argument("profile", type=str, help="Profile name")
+  set_color_preset_parser.add_argument("preset", type=str, help="Color preset name")
+  set_color_preset_parser.set_defaults(func=set_color_preset)
+
+  monitor_variable_parser = subparsers.add_parser("monitor-variable", help="Monitor changes to a variable")
+  monitor_variable_parser.add_argument("name", type=str, help="variable name")
+  monitor_variable_parser.add_argument('--session', type=str, nargs='?', help='Session ID for the variable scope')
+  monitor_variable_parser.add_argument('--tab', type=str, nargs='?', help='Tab ID for the variable scope')
+  monitor_variable_parser.add_argument('--window', type=str, nargs='?', help='Window ID for the variable scope')
+  monitor_variable_parser.add_argument('--app', action='store_true', help='App scope', default=False)
+  monitor_variable_parser.set_defaults(func=monitor_variable)
+
+  monitor_focus_parser = subparsers.add_parser("monitor-focus", help="Monitor changes to focus")
+  monitor_focus_parser.set_defaults(func=monitor_focus)
+
+  set_cursor_color_parser = subparsers.add_parser("set-cursor-color", help="Set cursor color")
+  set_cursor_color_parser.add_argument("session", type=str, help="Session ID")
+  set_cursor_color_parser.add_argument("color", type=str, help="Color as red,green,blue where each value is in 0-255")
+  set_cursor_color_parser.set_defaults(func=set_cursor_color)
+
+  monitor_screen_parser = subparsers.add_parser("monitor-screen", help="Monitor screen contents")
+  monitor_screen_parser.add_argument("session", type=str, help="Session ID")
+  monitor_screen_parser.add_argument("query", type=str, help="Stop when this text is seen")
+  monitor_screen_parser.set_defaults(func=monitor_screen)
+
+  show_selection_parser = subparsers.add_parser("show-selection", help="Shows the selected text in a session")
+  show_selection_parser.add_argument("session", type=str, help="Session ID")
+  show_selection_parser.set_defaults(func=show_selection)
+
+  return parser
+
+def main(argv):
+  logging.basicConfig()
+
+  parser = make_parser()
+  args = parser.parse_args(argv[1:])
+  if "func" not in args:
+    print(parser.format_help())
+    raise argparse.ArgumentTypeError('Missing command')
+
+  async def wrapper(connection):
+    try:
+      await args.func(connection, args)
+    except Exception as e:
+      print(traceback.format_exc())
+
+  iterm2.run_until_complete(wrapper)
+
+if __name__ == "__main__":
+  try:
+    main(sys.argv)
+  except Exception as e:
+    print(traceback.format_exc())
+    sys.exit(1)

.iterm2/it2cat

@@ -0,0 +1,195 @@
+#!/usr/bin/env bash
+
+set -o pipefail
+
+# tmux requires unrecognized OSC sequences to be wrapped with DCS tmux;
+# <sequence> ST, and for all ESCs in <sequence> to be replaced with ESC ESC. It
+# only accepts ESC backslash for ST. We use TERM instead of TMUX because TERM
+# gets passed through ssh.
+function print_osc() {
+    if [[ $TERM == screen* || $TERM == tmux* ]]; then
+        printf "\033Ptmux;\033\033]"
+    else
+        printf "\033]"
+    fi
+}
+
+# More of the tmux workaround described above.
+function print_st() {
+    if [[ $TERM == screen* || $TERM == tmux* ]]; then
+        printf "\a\033\\"
+    else
+        printf "\a"
+    fi
+}
+
+function load_version() {
+    if [ -z ${IT2CAT_BASE64_VERSION+x} ]; then
+        IT2CAT_BASE64_VERSION=$(base64 --version 2>&1)
+        export IT2CAT_BASE64_VERSION
+    fi
+}
+
+function b64_encode() {
+    load_version
+    if [[ $IT2CAT_BASE64_VERSION =~ GNU ]]; then
+        # Disable line wrap
+        base64 -w0
+    else
+        base64
+    fi
+}
+
+function b64_decode() {
+    load_version
+    if [[ $IT2CAT_BASE64_VERSION =~ fourmilab ]]; then
+        BASE64ARG=-d
+    elif [[ $IT2CAT_BASE64_VERSION =~ GNU ]]; then
+        BASE64ARG=-di
+    else
+        BASE64ARG=-D
+    fi
+    base64 $BASE64ARG
+}
+
+# print_file filename base64contents type mode
+#   filename: Filename to convey to client
+#   base64contents: Base64-encoded contents
+#   type: type hint
+#   mode: wide or regular
+function print_file() {
+    print_osc
+    printf "1337;File=inline=1"
+    printf ";size=%d" $(printf "%s" "$2" | b64_decode | wc -c)
+    [ -n "$1" ] && printf ";name=%s" "$(printf "%s" "$1" | b64_encode)"
+    [ -n "$3" ] && printf ";type=%s" "$3"
+    [ -n "$4" ] && printf ";mode=%s" "$4"
+    printf ":%s" "$2"
+    print_st
+    printf '\n'
+    did_print=t
+}
+
+function error() {
+    errcho "ERROR: $*"
+}
+
+function errcho() {
+    echo "$@" >&2
+}
+
+function show_help() {
+    errcho
+    errcho "Usage: it2cat [-w] [-t file-type] [-u] [-f] filename ..."
+    errcho "       cat filename | it2cat [-w] [-t file-type]"
+    errcho
+    errcho "Display a text file with native rendering."
+    errcho
+    errcho "Options:"
+    errcho
+    errcho "    -h, --help                      Display help message"
+    errcho "    -u, --url                       Interpret following filename arguments as remote URLs"
+    errcho "    -f, --file                      Interpret following filename arguments as regular Files"
+    errcho "    -t, --type file-type            Provides a type hint"
+    errcho "    -w, --wide                      Render in wide mode with a horizontal scrollbar"
+    errcho
+    errcho "    If a type is provided, it is used as a hint to disambiguate."
+    errcho "    The file type can be a mime type like text/markdown, a language name like Java, or a file extension like .c"
+    errcho "    The file type can usually be inferred from the extension or its contents. -t is most useful when"
+    errcho "    a filename is not available, such as whe input comes from a pipe."
+    errcho
+    errcho "Examples:"
+    errcho
+    errcho "    $ it2cat file.txt"
+    errcho "    $ cat graph.png | it2cat"
+    errcho "    $ it2cat -u http://example.com/path/to/file.txt -f otherfile.txt"
+    errcho "    $ cat url_list.txt | xargs it2cat -u"
+    errcho "    $ it2cat -w -t application/json config.json"
+    errcho
+}
+
+function check_dependency() {
+    if ! (builtin command -V "$1" >/dev/null 2>&1); then
+        error "missing dependency: can't find $1"
+        exit 1
+    fi
+}
+
+## Main
+
+if [ -t 0 ]; then
+    has_stdin=f
+else
+    has_stdin=t
+fi
+
+# Show help if no arguments and no stdin.
+if [ $has_stdin = f ] && [ $# -eq 0 ]; then
+    show_help
+    exit
+fi
+
+check_dependency base64
+check_dependency wc
+file_type=""
+mode=regular
+
+# Look for command line flags.
+while [ $# -gt 0 ]; do
+    case "$1" in
+    -h | --h | --help)
+        show_help
+        exit
+        ;;
+    -w | --w | --wide)
+        mode=wide
+        ;;
+    -f | --f | --file)
+        has_stdin=f
+        is_url=f
+        ;;
+    -u | --u | --url)
+        check_dependency curl
+        has_stdin=f
+        is_url=t
+        ;;
+    -t | --t | --type)
+         file_type="$2"
+         shift
+         ;;
+    -*)
+        error "Unknown option flag: $1"
+        show_help
+        exit 1
+        ;;
+    *)
+        if [ "$is_url" == "t" ]; then
+            encoded_file=$(curl -fs "$1" | b64_encode) || {
+                error "Could not retrieve file from URL $1, error_code: $?"
+                exit 2
+            }
+        elif [ -r "$1" ]; then
+            encoded_file=$(cat "$1" | b64_encode)
+        else
+            error "it2cat: $1: No such file or directory"
+            exit 2
+        fi
+        has_stdin=f
+        print_file "$1" "$encoded_file" "$file_type" "$mode"
+        ;;
+    esac
+    shift
+done
+
+# Read and print stdin
+if [ $has_stdin = t ]; then
+    print_file "" "$(cat | b64_encode)" "$file_type" "$mode"
+fi
+
+if [ "$did_print" != "t" ]; then
+    error "No file provided. Check command line options."
+    show_help
+    exit 1
+fi
+
+exit 0

.iterm2/it2git

@@ -0,0 +1,117 @@
+#!/usr/bin/env bash
+# This script sets iTerm2 user-defined variables describing the state of the git
+# repo in the current directory.
+#
+# For more information on the status bar, see:
+# https://www.iterm2.com/3.3/documentation-status-bar.html
+#
+# Installation instructions for this script:
+#
+# bash: Place this in .bashrc.
+# --------------------------------------------------------------------------------------
+# function iterm2_print_user_vars() {
+#   it2git
+# }
+
+# fish: Place this in ~/.config/fish/config.fish after the line
+#       "source ~/.iterm2_shell_integration.fish".
+# --------------------------------------------------------------------------------------
+# function iterm2_print_user_vars
+#   it2git
+# end
+
+# tcsh: Place this in .tcshrc
+# --------------------------------------------------------------------------------------
+# alias get_current_branch "bash -c '((git branch 2> /dev/null) | grep \* | cut -c3-)'"
+# alias _iterm2_user_defined_vars 'it2git'
+
+# zsh:Place this in .zshrc after "source /Users/georgen/.iterm2_shell_integration.zsh".
+# --------------------------------------------------------------------------------------
+# iterm2_print_user_vars() {
+#   it2git
+# }
+
+GIT_BINARY=/usr/bin/git
+
+dirty() {
+    # Outputs "dirty" or "clean"
+    OUTPUT=$("$GIT_BINARY" status --porcelain --ignore-submodules -unormal 2>/dev/null)
+    if (($?)); then
+        echo "clean"
+        return
+    fi
+    if [ -z "$OUTPUT" ]; then
+        echo "clean"
+    else
+        echo "dirty"
+    fi
+}
+
+counts() {
+    OUTPUT=$("$GIT_BINARY" rev-list --left-right --count HEAD...@'{u}' 2>/dev/null)
+    if (($?)); then
+        echo "error"
+        return
+    fi
+    echo "$OUTPUT"
+}
+
+branch() {
+    OUTPUT=$("$GIT_BINARY" symbolic-ref -q --short HEAD 2>/dev/null || git rev-parse --short HEAD 2>/dev/null)
+    if (($?)); then
+        return
+    fi
+    echo "$OUTPUT"
+}
+
+adds() {
+    "${GIT_BINARY}" ls-files --others --exclude-standard | wc -l
+}
+
+deletes() {
+    "${GIT_BINARY}" ls-files --deleted --exclude-standard | wc -l
+}
+function iterm2_begin_osc {
+  printf "\033]"
+}
+
+function iterm2_end_osc {
+  printf "\007"
+}
+
+function iterm2_set_user_var() {
+  iterm2_begin_osc
+  printf "1337;SetUserVar=%s=%s" "$1" $(printf "%s" "$2" | base64 | tr -d '\n')
+  iterm2_end_osc
+}
+
+git_poll () {
+    DIRECTORY="$1"
+    cd "$DIRECTORY"
+    DIRTY=$(dirty)
+    COUNTS=$(counts)
+    PUSH_COUNT=$(cut -f1 <<< "$COUNTS")
+    PULL_COUNT=$(cut -f2 <<< "$COUNTS")
+    BRANCH=$(branch)
+
+    iterm2_set_user_var gitBranch "$BRANCH"
+    iterm2_set_user_var gitDirty "$DIRTY"
+    iterm2_set_user_var gitPushCount "$PUSH_COUNT"
+    iterm2_set_user_var gitPullCount "$PULL_COUNT"
+    iterm2_set_user_var gitAdds "$ADDS"
+    iterm2_set_user_var gitDeletes "$DELETES"
+}
+
+"$GIT_BINARY" rev-parse --git-dir 2>/dev/null >/dev/null
+if (($?)); then
+    iterm2_set_user_var gitBranch ""
+    iterm2_set_user_var gitDirty ""
+    iterm2_set_user_var gitPushCount ""
+    iterm2_set_user_var gitPullCount ""
+    iterm2_set_user_var gitAdds ""
+    iterm2_set_user_var gitDeletes ""
+else
+    git_poll "$PWD"
+fi
+
+

.iterm2/it2profile

@@ -0,0 +1,170 @@
+#!/usr/bin/env bash
+
+set -o pipefail
+
+# tmux requires unrecognized OSC sequences to be wrapped with DCS tmux;
+# <sequence> ST, and for all ESCs in <sequence> to be replaced with ESC ESC. It
+# only accepts ESC backslash for ST.
+function print_osc() {
+    if [[ $TERM == screen* || $TERM == tmux* ]] ; then
+        printf "\033Ptmux;\033\033]"
+    else
+        printf "\033]"
+    fi
+}
+
+# More of the tmux workaround described above.
+function print_st() {
+    if [[ $TERM == screen* || $TERM == tmux* ]] ; then
+        printf "\a\033\\"
+    else
+        printf "\a"
+    fi
+}
+
+function get_b64_version() {
+    if [[ -z "${BASE64_VERSION+x}" ]]; then
+        BASE64_VERSION=$(base64 --version 2>&1)
+        export BASE64_VERSION
+    fi
+}
+
+function b64_encode() {
+    get_b64_version
+    if [[ $BASE64_VERSION =~ GNU ]]; then
+        # Disable line wrap
+        base64 -w0
+    else
+        base64
+    fi
+}
+
+function b64_decode() {
+    get_b64_version
+    if [[ $BASE64_VERSION =~ fourmilab ]]; then
+        BASE64_ARG=-d
+    elif [[ $BASE64_VERSION =~ GNU ]]; then
+        BASE64_ARG=-di
+    else
+        BASE64_ARG=-D
+    fi
+    base64 $BASE64_ARG
+}
+
+function error() {
+    errcho "ERROR: $*"
+}
+
+function errcho() {
+    echo "$@" >&2
+}
+
+function show_help() {
+    errcho
+    errcho "Usage: it2profile -s profile_name"
+    errcho "       it2profile -g"
+    errcho
+    errcho "Change iTerm2 session profile on the fly"
+    errcho
+    errcho "Options:"
+    errcho
+    errcho "    -s      Set current iTerm2 session profile to specified profile name"
+    errcho "                empty string refers to profile marked as Default"
+    errcho "    -g      Get current iTerm2 session profile name"
+    errcho "    -r      Reset to the session initial profile"
+    errcho
+}
+
+function check_dependency() {
+    if ! (builtin command -V "$1" >/dev/null 2>&1); then
+        error "missing dependency: can't find $1"
+        exit 1
+    fi
+}
+
+# get_profile / set_profile
+#
+# These functions uses POSIX standard synonym for the controlling terminal
+# associated with the current process group - /dev/tty. It is useful for programs 
+# that wish to be sure of writing or reading data from the terminal 
+# no matter how STDIN/STDOUT/STDERR has been redirected.
+# 
+# get_profile uses iTerm2 Session Context variable "profileName" to 
+# get currently active profile name.
+#
+function get_profile() {
+    trap 'cleanup' EXIT
+    stty -echo < /dev/tty
+    exec 9<> /dev/tty
+    print_osc >&9
+    printf "1337;ReportVariable=cHJvZmlsZU5hbWU=" >&9
+    print_st >&9
+    read -r -t 5 -d $'\a' iterm_response <&9
+    exec 9>&-
+    stty echo < /dev/tty
+    [[ "$iterm_response" =~ ReportVariable= ]] || {
+        error "Failed to read response from iTerm2"
+        exit 2
+    }
+    echo "$(b64_decode <<< ${iterm_response#*=})"
+}
+
+function cleanup() {
+    stty echo < /dev/tty
+}
+
+function set_profile() {
+    exec 9> /dev/tty
+    print_osc >&9
+    printf '1337;SetProfile=%s' "$1" >&9
+    print_st >&9
+    exec 9>&-
+}
+
+# Show help if no arguments
+if [ $# -eq 0 ]; then
+    show_help
+    exit
+fi
+
+check_dependency stty
+check_dependency base64
+
+# Process command line arguments
+case "$1" in
+    -h|--h|--help)
+        show_help
+        exit
+        ;;
+    -s|--s|--set)
+        [[ $# -eq 2 ]] || {
+            error "-s option requires exactly 1 argument - profile name"
+            show_help
+            exit 1
+        }
+        set_profile "$2"
+        ;;
+    -g|--g|--get)
+        [[ $# -eq 1 ]] || {
+            error "-g option does not accept any argument"
+            show_help
+            exit 1
+        }
+        get_profile
+        ;;
+    -r|--r|--reset)
+        [[ $# -eq 1 ]] || {
+            error "-r option does not accept any argument"
+            show_help
+            exit 1
+        }
+        set_profile "${ITERM_PROFILE:-}"
+        ;;
+    *)
+        error "Unknown option: $1"
+        show_help
+        exit 1
+        ;;
+esac
+
+exit 0

.iterm2/it2tip

@@ -0,0 +1,546 @@
+#!/usr/bin/env python3
+
+import os
+import sys
+
+tips = [
+    {
+      "title": "Shell Integration",
+      "body": "The big new feature of iTerm2 version 3 is Shell Integration. Click “Learn More” for all the details.",
+      "url": "https://iterm2.com/shell_integration.html"
+      },
+    {
+      "title": "Timestamps",
+      "body": "“View > Show Timestamps” shows the time (and date, if appropriate) when each line was last modified."
+      },
+    {
+      "title": "Password Manager",
+      "body": "Did you know iTerm2 has a password manager? Open it with “Window > Password Manager.” You can define a Trigger to open it for you at a password prompt in “Prefs > Profiles > Advanced > Triggers.”"
+      },
+    {
+      "title": "Open Quickly",
+      "body": "You can quickly search through your sessions with “View > Open Quickly” (⇧⌘O). You can type a query and sessions whose name, badge, current hostname, current user name, recent commands, and recent working directories match will be surfaced. It works best with Shell Integration so the user name, hostname, command, and directories can be known even while sshed.",
+      "url": "https://iterm2.com/shell_integration.html"
+      },
+    {
+      "title": "Undo Close",
+      "body": "If you close a session, tab, or window by accident you can undo it with “Edit > Undo” (⌘Z). By default you have five seconds to undo, but you can adjust that timeout in “Prefs > Profiles > Session.”"
+      },
+    {
+      "title": "Annotations",
+      "body": "Want to mark up your scrollback history? Right click on a selection and choose “Annotate Selection” to add a personal note to it. Use “View > Show Annotations” to show or hide them, and look in “Edit > Marks and Annotations” for more things you can do."
+      },
+    {
+      "title": "Copy with Styles",
+      "body": "Copy a selection with ⌥⌘C to include styles such as colors and fonts. You can make this the default action for Copy in “Prefs > Advanced.”"
+      },
+    {
+      "title": "Inline Images",
+      "body": "iTerm2 can display images (even animated GIFs) inline.",
+      "url": "https://iterm2.com/images.html"
+      },
+    {
+      "title": "Automatic Profile Switching",
+      "body": "Automatic Profile Switching changes the current profile when the username, hostname, or directory changes. Set it up in “Prefs > Profiles > Advanced.” It requires Shell Integration to be installed.",
+      "url": "https://iterm2.com/shell_integration.html"
+      },
+    {
+      "title": "Captured Output",
+      "body": "iTerm2 can act like an IDE using the Captured Output feature. When it sees text matching a regular expression you define, like compiler errors, it shows the matching lines in the Toolbelt. You can click to jump to the line in your terminal and double-click to perform an action like opening an editor to the line with the error.",
+      "url": "https://iterm2.com/captured_output.html"
+      },
+    {
+      "title": "Badges",
+      "body": "You can display a status message in the top right of your session in the background. It’s called a “Badge.” If you install Shell Integration you can include info like user name, hostname, current directory, and more.",
+      "url": "https://iterm2.com/badges.html"
+      },
+    {
+        "title": "Dynamic Profiles",
+        "body": "Dynamic Profiles let you store your profiles as one or more JSON files. It’s great for batch creating and editing profiles.",
+        "url": "https://iterm2.com/dynamic-profiles.html"
+        },
+    {
+        "title": "Advanced Paste",
+        "body": "“Edit > Paste Special > Advanced Paste” lets you preview and edit text before you paste. You get to tweak options, like how to handle control codes, or even to base-64 encode before pasting."
+        },
+    {
+        "title": "Zoom",
+        "body": "Ever wanted to focus on a block of lines without distraction, or limit Find to a single command’s output? Select the lines and choose “View > Zoom In on Selection.” The session’s contents will be temporarily replaced with the selection. Press “esc” to unzoom."
+        },
+    {
+        "title": "Semantic History",
+        "body": "The “Semantic History” feature allows you to ⌘-click on a file or URL to open it."
+        },
+    {
+        "title": "Tmux Integration",
+        "body": "If you use tmux, try running “tmux -CC” to get iTerm2’s tmux integration mode. The tmux windows show up as native iTerm2 windows, and you can use iTerm2’s keyboard shortcuts. It even works over ssh!",
+        "url": "https://gitlab.com/gnachman/iterm2/wikis/TmuxIntegration"
+        },
+    {
+        "title": "Triggers",
+        "body": "iTerm2 can automatically perform actions you define when text matching a regular expression is received. For example, you can highlight text or show an alert box. Set it up in “Prefs > Profiles > Advanced > Triggers.”",
+        "url": "https://www.iterm2.com/documentation-triggers.html"
+        },
+    {
+        "title": "Smart Selection",
+        "body": "Quadruple click to perform Smart Selection. It figures out if you’re selecting a URL, filename, email address, etc. based on prioritized regular expressions.",
+        "url": "https://www.iterm2.com/smartselection.html"
+        },
+    {
+        "title": "Instant Replay",
+        "body": "Press ⌥⌘B to step back in time in a terminal window. Use arrow keys to go frame by frame. Hold ⇧ and press arrow keys to go faster."
+        },
+    {
+        "title": "Hotkey Window",
+        "body": "You can have a terminal window open with a keystroke, even while in other apps. Click “Create a Dedicated Hotkey Window” in “Prefs > Keys.”"
+        },
+    {
+        "title": "Hotkey Window",
+        "body": "Hotkey windows can stay open after losing focus. Turn it on in “Window > Pin Hotkey Window.”"
+        },
+    {
+        "title": "Cursor Guide",
+        "body": "The cursor guide is a horizontal line that follows your cursor. You can turn it on in “Prefs > Profiles > Colors” or toggle it with the ⌥⌘; shortcut."
+        },
+    {
+        "title": "Shell Integration: Alerts",
+        "body": "The Shell Integration feature lets you ask to be alerted (⌥⌘A) when a long-running command completes.",
+        "url": "https://iterm2.com/shell_integration.html"
+        },
+    {
+        "title": "Cursor Blink Rate",
+        "body": "You can configure how quickly the cursor blinks in “Prefs > Advanced.”"
+        },
+    {
+        "title": "Shell Integration: Navigation",
+        "body": "The Shell Integration feature lets you navigate among shell prompts with ⇧⌘↑ and ⇧⌘↓.",
+        "url": "https://iterm2.com/shell_integration.html"
+        },
+    {
+        "title": "Shell Integration: Status",
+        "body": "The Shell Integration feature puts a blue arrow next to your shell prompt. If you run a command that fails, it turns red. Right click on it to get the running time and status.",
+        "url": "https://iterm2.com/shell_integration.html"
+        },
+    {
+        "title": "Shell Integration: Selection",
+        "body": "With Shell Integration installed, you can select the output of the last command with ⇧⌘A.",
+        "url": "https://iterm2.com/shell_integration.html"
+        },
+    {
+        "title": "Bells",
+        "body": "The dock icon shows a count of the number of bells rung and notifications posted since the app was last active."
+        },
+    {
+        "title": "Shell Integration: Downloads",
+        "body": "If you install Shell Integration on a machine you ssh to, you can right click on a filename (for example, in the output of “ls”) and choose “Download with scp” to download the file.",
+        "url": "https://iterm2.com/shell_integration.html"
+        },
+    {
+        "title": "Find Your Cursor",
+        "body": "Press ⌘/ to locate your cursor. It’s fun!"
+        },
+    {
+        "title": "Customize Smart Selection",
+        "body": "You can edit Smart Selection regular expressions in “Prefs > Profiles > Advanced > Smart Selection.”",
+        "url": "https://www.iterm2.com/smartselection.html"
+        },
+    {
+        "title": "Smart Selection Actions",
+        "body": "Assign an action to a Smart Selection rule in “Prefs > Profiles > Advanced > Smart Selection > Edit Actions.” They go in the context menu and override semantic history on ⌘-click.",
+        "url": "https://www.iterm2.com/smartselection.html"
+        },
+    {
+        "title": "Visual Bell",
+        "body": "If you want the visual bell to flash the whole screen instead of show a bell icon, you can turn that on in “Prefs > Advanced.”"
+        },
+    {
+        "title": "Tab Menu",
+        "body": "Right click on a tab to change its color, close tabs after it, or to close all other tabs."
+        },
+    {
+        "title": "Tags",
+        "body": "You can assign tags to your profiles, and by clicking “Tags>” anywhere you see a list of profiles you can browse those tags."
+        },
+    {
+        "title": "Tag Hierarchy",
+        "body": "If you put a slash in a profile’s tag, that implicitly defines a hierarchy. You can see it in the Profiles menu as nested submenus."
+        },
+    {
+        "title": "Downloads",
+        "body": "iTerm2 can download files by base-64 encoding them. Click “Learn More” to download a shell script that makes it easy.",
+        "url": "https://iterm2.com/download.sh"
+        },
+    {
+        "title": "Command Completion",
+        "body": "If you install Shell Integration, ⇧⌘; helps you complete commands. It remembers the commands you’ve run on each host that has Shell Integration installed. It knows how often that command was run and how recently to help make the best suggestions.",
+        "url": "https://iterm2.com/shell_integration.html"
+        },
+    {
+        "title": "Recent Directories",
+        "body": "iTerm2 remembers which directories you use the most on each host that has Shell Integration installed. There’s a Toolbelt tool to browse them, and ⌥⌘/ gives you a popup sorted by frequency and recency of use.",
+        "url": "https://iterm2.com/shell_integration.html"
+        },
+    {
+        "title": "Favorite Directories",
+        "body": "If you have Shell Integration installed, you can “star” a directory to keep it always at the bottom of the Recent Directories tool in the Toolbelt. Right click and choose “Toggle Star.”",
+        "url": "https://iterm2.com/shell_integration.html"
+        },
+    {
+        "title": "Shell Integration History",
+        "body": "Install Shell Integration and turn on “Prefs > General > Save copy/paste and command history to disk” to remember command history per host across restarts of iTerm2.",
+        "url": "https://iterm2.com/shell_integration.html"
+        },
+    {
+        "title": "Paste File as Base64",
+        "body": "Copy a file to the pasteboard in Finder and then use “Edit > Paste Special > Paste File Base64-Encoded” for easy uploads of binary files. Use ”base64 -D” (or -d on Linux) on the remote host to decode it."
+        },
+    {
+        "title": "Split Panes",
+        "body": "You can split a tab into multiple panes with ⌘D and ⇧⌘D."
+        },
+    {
+        "title": "Adjust Split Panes",
+        "body": "Resize split panes with the keyboard using ^⌘-Arrow Key."
+        },
+    {
+        "title": "Move Cursor",
+        "body": "Hold ⌥ and click to move your cursor. It works best with Shell Integration installed (to avoid sending up/down arrow keys to your shell).",
+        "url": "https://iterm2.com/shell_integration.html"
+        },
+    {
+        "title": "Edge Windows",
+        "body": "You can tell your profile to create windows that are attached to one edge of the screen in “Prefs > Profiles > Window.” You can resize them by dragging the edges."
+        },
+    {
+        "title": "Tab Color",
+        "body": "You can assign colors to tabs in “Prefs > Profiles > Colors,” or in the View menu."
+        },
+    {
+        "title": "Rectangular Selection",
+        "body": "Hold ⌥⌘ while dragging to make a rectangular selection."
+        },
+    {
+        "title": "Multiple Selection",
+        "body": "Hold ⌘ while dragging to make multiple discontinuous selections."
+        },
+    {
+        "title": "Dragging Panes",
+        "body": "Hold ⇧⌥⌘ and drag a session into another session to create or change split panes."
+        },
+    {
+        "title": "Cursor Boost",
+        "body": "Adjust Cursor Boost in “Prefs > Profiles > Colors” to make all colors more muted, except the cursor. Use a bright white cursor and it pops!"
+        },
+    {
+        "title": "Minimum Contrast",
+        "body": "Adjust “Minimum Contrast” in “Prefs > Profiles > Colors” to ensure text is always legible regardless of text/background color combination."
+        },
+    {
+        "title": "Tabs",
+        "body": "Normally, new tabs appear at the end of the tab bar. There’s a setting in “Prefs > Advanced” to place them next to your current tab."
+        },
+    {
+        "title": "Base Conversion",
+        "body": "Right-click on a number and the context menu shows it converted to hex or decimal as appropriate."
+        },
+    {
+        "title": "Saved Searches",
+        "body": "In “Prefs > Keys” you can assign a keystroke to a search for a regular expression with the “Find Regular Expression…” action."
+        },
+    {
+        "title": "Find URLs",
+        "body": "Search for URLs using “Edit > Find > Find URLs.” Navigate search results with ⌘G and ⇧⌘G. Open the current selection with ⌥⌘O."
+        },
+    {
+        "title": "Triggers",
+        "body": "The “instant” checkbox in a Trigger allows it to fire while the cursor is on the same line as the text that matches your regular expression."
+        },
+    {
+        "title": "Soft Boundaries",
+        "body": "Turn on “Edit > Selection Respects Soft Boundaries” to recognize split pane dividers in programs like vi, emacs, and tmux so you can select multiple lines of text."
+        },
+    {
+        "title": "Select Without Dragging",
+        "body": "Single click where you want to start a selection and ⇧-click where you want it to end to select text without dragging."
+        },
+    {
+        "title": "Smooth Window Resizing",
+        "body": "Hold ^ while resizing a window and it won’t snap to the character grid: you can make it any size you want."
+        },
+    {
+        "title": "Pasting Tabs",
+        "body": "If you paste text containing tabs, you’ll be asked if you want to convert them to spaces. It’s handy at the shell prompt to avoid triggering filename completion."
+        },
+    {
+        "title": "Bell Silencing",
+        "body": "Did you know? If the bell rings too often, you’ll be asked if you’d like to silence it temporarily. iTerm2 cares about your comfort."
+        },
+    {
+        "title": "Profile Search",
+        "body": "Every list of profiles has a search field (e.g., in ”Prefs > Profiles.”) You can use various operators to restrict your search query. Click “Learn More” for all the details.",
+        "url": "https://iterm2.com/search_syntax.html"
+        },
+    {
+        "title": "Color Schemes",
+        "body": "The online color gallery features over one hundred beautiful color schemes you can download.",
+        "url": "https://www.iterm2.com/colorgallery"
+        },
+    {
+        "title": "ASCII/Non-Ascii Fonts",
+        "body": "You can have a separate font for ASCII versus non-ASCII text. Enable it in “Prefs > Profiles > Text.”"
+        },
+    {
+        "title": "Coprocesses",
+        "body": "A coprocess is a job, such as a shell script, that has a special relationship with a particular iTerm2 session. All output in a terminal window (that is, what you see on the screen) is also input to the coprocess. All output from the coprocess acts like text that the user is typing at the keyboard.",
+        "url": "https://iterm2.com/coprocesses.html"
+        },
+    {
+        "title": "Touch Bar Customization",
+        "body": "You can customize the touch bar by selecting “View > Customize Touch Bar.” You can add a tab bar for full-screen mode, a user-customizable status button, and you can even define your own touch bar buttons in Prefs > Keys. There’s also a new shell integration tool to customize touch bar function key labels."
+        },
+    {
+        "title": "Ligatures",
+        "body": "If you use a font that supports ligatures, you can enable ligature support in Prefs > Profiles > Text."
+        },
+    {
+        "title": "Floating Hotkey Window",
+        "body": "New in 3.1: You can configure your hotkey window to appear over other apps’ full screen windows. Turn on “Floating Window” in “Prefs > Profiles > Keys > Customize Hotkey Window.”"
+        },
+    {
+        "title": "Multiple Hotkey Windows",
+        "body": "New in 3.1: You can have multiple hotkey windows. Each profile can have one or more hotkeys."
+        },
+    {
+        "title": "Double-Tap Hotkey",
+        "body": "New in 3.1: You can configure a hotkey window to open on double-tap of a modifier in “Prefs > Profiles > Keys > Customize Hotkey Window.”"
+        },
+    {
+        "title": "Buried Sessions",
+        "body": "You can “bury” a session with “Session > Bury Session.” It remains hidden until you restore it by selecting it from “Session > Buried Sessions > Your session.”"
+        },
+    {
+        "title": "Python API",
+        "body": "You can add custom behavior to iTerm2 using the Python API.",
+        "url": "https://iterm2.com/python-api"
+        },
+    {
+        "title": "Status Bar",
+        "body": "You can add a configurable status bar to your terminal windows.",
+        "url": "https://iterm2.com/3.3/documentation-status-bar.html"
+        },
+    {
+        "title": "Minimal Theme",
+        "body": "Try the “Minimal” and “Compact” themes to reduce visual clutter. You can set it in “Prefs > Appearance > General.”"
+        },
+    {
+        "title": "Session Titles",
+        "body": "You can configure which elements are present in session titles in “Prefs > Profiles > General > Title.”"
+        },
+    {
+        "title": "Tab Icons",
+        "body": "Tabs can show an icon indicating the current application. Configure it in “Prefs > Profiles > General > Icon.”"
+        },
+    {
+        "title": "Drag Window by Tab",
+        "body": "Hold ⌥ while dragging a tab to move the window. This is useful in the Compact and Minimal themes, which have a very small area for dragging the window."
+        },
+    {
+        "title": "Composer",
+        "body": "Press ⇧⌘. to open the Composer. It gives you a scratchpad to edit a command before sending it to the shell."
+        },
+    {
+        "title": "Shell Integration: Uploads",
+        "body": "If you install Shell Integration on a machine you ssh to, you can drag-drop from Finder into the remote host by holding ⌥ while dragging. The destination directory is determined by where you drop the file in the terminal window: run cd foo, then drop the file below the cd command, and the file will go into the foo directory.",
+        "url": "https://iterm2.com/shell_integration.html"
+        },
+    {
+        "title": "Composer Power Features",
+        "body": "The composer supports multiple cursors. It also has the ability to send just one command out of a list, making it easy to walk through a list of commands one-by-one. Click the help button in the composer for details."
+        },
+
+    { "title": "Render Selection",
+        "body": "Transform selected text into a prettified, syntax-highlighted view with the “Render Selection” command, ideal for JSON, Markdown, or source code. This feature includes horizontal scrolling for easy log navigation."
+        },
+
+    { "title": "SSH Integration",
+        "body": "Export environment variables and copy files to remote hosts seamlessly with SSH integration. Either configure a profile to use ssh or use it2ssh in place of ssh."
+        },
+
+    { "title": "Auto Composer",
+        "body": "Improve your command line with the “auto composer”, which replaces the command line with a native control for ease of use. Requires shell integration."
+        },
+
+    { "title": "AI Command Writing",
+        "body": "Generate commands using AI by entering a prompt in the composer and selecting “Edit > Engage Artificial Intelligence”. An OpenAI API key is required for this functionality."
+        },
+
+    { "title": "Codecierge Tool",
+        "body": "Set and achieve terminal goals with “Codecierge”, a Toolbelt feature that guides you step-by-step based on your terminal activity. An OpenAI API key is necessary for this feature."
+        },
+
+    { "title": "Named Marks",
+        "body": "Navigate your command history effortlessly with “named marks” by assigning names to lines in the terminal."
+        },
+
+    { "title": "Font Assignments",
+        "body": "You can assign specific fonts to Unicode ranges. Use 'Settings > Profiles > Text > Manage Special Exceptions' to manage it and to install a huge set of Powerline symbols."
+        },
+
+    { "title": "Disable Transparency",
+        "body": "Maintain clarity in your active window while enjoying transparency in background windows by using 'View > Disable transparency in key window'."
+        },
+
+    { "title": "Leader Shortcut",
+        "body": "Create two-keystroke shortcuts with a “leader”: a special keystroke that precedes a custom key binding."
+        },
+
+    { "title": "Sequence Binding",
+        "body": "Execute a series of actions in order with a single shortcut using “sequence” key bindings."
+        },
+
+    { "title": "Export/Import Settings",
+        "body": "Easily backup or transfer your iTerm2 settings using the Export/Import feature in “Settings > General > Preferences”."
+        },
+
+    { "title": "Multi-Session Bindings",
+        "body": "Apply key bindings uniformly across multiple sessions for consistent control in different tabs or windows."
+        },
+
+    { "title": "Inject Trigger",
+        "body": "Simulate terminal input as if it were output from a running app with the “Inject” trigger."
+        },
+
+    { "title": "Trigger Status Bar",
+        "body": "Easily manage your triggers using the new Triggers status bar component."
+        },
+
+    { "title": "Session Size in Tab",
+        "body": "Display session size directly in tab titles for convenient at-a-glance information."
+        },
+
+    { "title": "Advanced Snippet Editing",
+        "body": "Edit snippets in Advanced Paste by holding the ⌥ key, or open them in the composer with ⇧."
+        },
+
+    { "title": "HTML Logs",
+        "body": "Save your terminal logs in HTML format for enhanced readability and sharing capabilities."
+        },
+
+    { "title": "ASCIICast Logs",
+        "body": "Create and play back terminal recordings with ASCIICast logs, compatible with asciinema."
+        },
+
+    { "title": "Timestamped Logs",
+        "body": "Include timestamps in your logs for better tracking and event correlation."
+        },
+
+    { "title": "LastPass & 1Password",
+        "body": "Utilize LastPass or 1Password with the password manager by configuring it in the menu next to the search field."
+        },
+
+    { "title": "Password Manager Access",
+        "body": "Access your password manager without authentication by adjusting the settings via the menu next to its search field."
+        },
+
+    { "title": "Password Generation",
+        "body": "Generate strong, secure passwords using the password manager’s new password generation feature."
+        },
+
+    { "title": "it2tip Utility",
+        "body": "Access tips of the day with the it2tip utility, a command line app. Enable it by installing shell integration and utilities."
+        },
+
+    { "title": "Auto Shell Integration",
+        "body": "Experience automatic shell integration when creating a login shell, removing the need for explicit setup on your Mac."
+        },
+
+    { "title": "Command Prompt Info",
+        "body": "Get detailed information about commands by ⌘-clicking on the command prompt."
+        },
+
+    { "title": "tmux Integration",
+        "body": "Use tmux integration for automatic key bindings that emulate tmux’s shortcuts, configurable via the Leader settings."
+        },
+
+    { "title": "tmux Clipboard Mirroring",
+        "body": "Sync your tmux paste buffer with the local clipboard for seamless integration (requires tmux 3.4)."
+        },
+
+    { "title": "Multi-Cursor in Composer",
+        "body": "Enhance your editing in the Composer with multiple cursors, created using ^⇧-up/down or ⌥-drag."
+        },
+
+    { "title": "Advanced Paste from Composer",
+        "body": "Move content from the Composer to the Advanced Paste window with ⌥⌘V for additional editing options."
+        },
+
+    { "title": "Composer Search",
+        "body": "Search within the Composer using ⌘F to quickly find specific text."
+        },
+
+    { "title": "Resize Composer",
+        "body": "Adjust the Composer’s height to suit your needs by dragging its bottom edge."
+        },
+
+    { "title": "Explain Command",
+        "body": "Learn more about your commands by ⌘-clicking in the Composer to open them in explainshell.com."
+        },
+
+    { "title": "Quick Command Send",
+        "body": "Quickly send and remove commands in the Composer using ⌥⇧-enter."
+        },
+
+    { "title": "Queue Commands",
+        "body": "Queue up a command in the Composer to be sent after the current command finishes with ⌥-Enter."
+        },
+
+    { "title": "Draggable Tip Window",
+        "body": "Reposition the Tip of the Day window conveniently on your screen, as it is now draggable."
+        },
+
+  ]
+
+
+home = os.getenv("XDG_DATA_HOME")
+if not home:
+  home = "~"
+
+RCFILE = os.path.expanduser(os.path.join(home, '.it2totd'))
+
+def last_index():
+  try:
+    with open(RCFILE) as f:
+      lines = f.readlines()
+      return int(lines[0].rstrip())
+  except:
+    return -1
+
+def print_tip(i):
+  def dcs(args):
+    return "\x1bP" + ";".join(args)
+
+  def osc(args):
+    term = os.getenv("TERM")
+    if term.startswith("screen"):
+      return dcs(["tmux", "\x1b\x1b]"]) + ";".join(args) + "\a\x1b\\"
+    else:
+      return "\x1b]" + ";".join(args) + "\x1b\\"
+
+  tip = tips[i]
+  print(f'iTerm2 tip - {tip["title"]}:')
+  print(tip["body"])
+  if "url" in tip:
+    print("Learn more: " + osc(["8", "", tip["url"]]) + tip["url"] + osc(["8", "", ""]))
+
+def save_index(i):
+  with open(RCFILE, "w") as f:
+    f.write(str(i))
+
+i = last_index() + 1
+if i >= len(tips) and len(sys.argv) > 1 and sys.argv[1] == "-w":
+  i = 0
+
+if i < len(tips):
+  print_tip(i)
+  save_index(i)
+