feature: add iterm2-utils

diff --git a/iterm-utils/install.sh b/iterm-utils/install.sh
new file mode 100644 (file)
index 0000000..7ade9a5
--- /dev/null
+++ b/iterm-utils/install.sh
@@ -0,0 +1,10 @@
+# title: iterm-utils (iterm2-utils alias)
+# homepage: https://webinstall.dev/iterm2-utils
+# tagline: Alias for https://webinstall.dev/iterm2-utils
+# alias: iterm2-utils
+# description: |
+#   See https://webinstall.dev/iterm2-utils
+
+echo "'iterm-utils@${WEBI_TAG:-stable}' is an alias for 'iterm2-utils@${WEBI_VERSION:-}'"
+WEBI_HOST=${WEBI_HOST:-"https://webinstall.dev"}
+curl -fsSL "$WEBI_HOST/iterm2-utils@${WEBI_VERSION:-}" | bash

diff --git a/iterm2-utils/README.md b/iterm2-utils/README.md
new file mode 100644 (file)
index 0000000..5b020ca
--- /dev/null
+++ b/iterm2-utils/README.md
@@ -0,0 +1,43 @@
+---
+title: iTerm2 Shell Integrations
+homepage: https://iterm2.com/documentation-shell-integration.html
+tagline: |
+  iTerm2 Shell Integrations enable several useful features.
+---
+
+To update, just run `webi iterm2-utils` again.
+
+Note: On first use you'll need to source the new config, or login and login
+again.
+
+```bash
+source ~/.iterm2_shell_integration.bash
+```
+
+## Cheat Sheet
+
+> iTerm2 may be integrated with the unix shell so that it can keep track of your
+> command history, current working directory, host name, and more—even over ssh.
+
+This downloads and runs the same exact script that runs if you select the
+_iTerm2>Install Shell Integration_ menu item.\
+(the advantage being that you can use the CLI! _Look ma', no GUI!_)
+
+In addition to enabling [automatic profile switching](./iterm2), the following
+utilities will also be installed.
+
+| iterm2 Util            | Description                                                       |
+| :--------------------- | :---------------------------------------------------------------- |
+| imgcat filename        | Displays the image inline.                                        |
+| imgls                  | Shows a directory listing with image thumbnails.                  |
+| it2api                 | Command-line utility to manipulate iTerm2.                        |
+| it2attention fireworks | Gets your attention.                                              |
+| it2check               | Checks if the terminal is iTerm2.                                 |
+| it2copy [filename]     | Copies to the pasteboard.                                         |
+| it2dl filename         | Downloads the specified file, saving it in your Downloads folder. |
+| it2setcolor ...        | Changes individual color settings or loads a color preset.        |
+| it2setkeylabel ...     | Changes Touch Bar function key labels.                            |
+| it2ul                  | Uploads a file.                                                   |
+| it2universion          | Sets the current unicode version.                                 |
+
+To learn more, see <https://iterm2.com/documentation-shell-integration.html>.

diff --git a/iterm2-utils/install.sh b/iterm2-utils/install.sh
new file mode 100644 (file)
index 0000000..4f727ca
--- /dev/null
+++ b/iterm2-utils/install.sh
@@ -0,0 +1,7 @@
+#!/bin/bash
+
+function __iterm2_utils() {
+    curl -fsSL https://iterm2.com/shell_integration/install_shell_integration_and_utilities.sh | bash
+}
+
+__iterm2_utils