vladislav doster 1d09c6bb0a style: remove trailing whitespace (#12303) 4 weeks ago
..
README.md 1d09c6bb0a style: remove trailing whitespace (#12303) 4 weeks ago
iterm2.plugin.zsh 1d09c6bb0a style: remove trailing whitespace (#12303) 4 weeks ago
iterm2_shell_integration.zsh 1d09c6bb0a style: remove trailing whitespace (#12303) 4 weeks ago
update bd9c216fe0 feat(iterm2): add shell integration script (#11509) 1 year ago

README.md

iTerm2 plugin

This plugin adds a few functions that are useful when using iTerm2.

To use it, add iterm2 to the plugins array of your zshrc file:

plugins=(... iterm2)

Optionally, the plugin also applies the Shell Integration Script for iTerm2. You can enable the integration with zstyle. It's important to add this line before the line sourcing oh-my-zsh:

zstyle :omz:plugins:iterm2 shell-integration yes

Plugin commands

  • _iterm2_command <iterm2-command> executes an arbitrary iTerm2 command via an escape code sequence. See https://iterm2.com/documentation-escape-codes.html for all supported commands.

  • iterm2_profile <profile-name> changes the current terminal window's profile (colors, fonts, settings, etc). profile-name is the name of another iTerm2 profile. The profile name can contain spaces.

  • iterm2_tab_color <red> <green> <blue> changes the color of iTerm2's currently active tab. red/green/blue are on the range 0-255.

  • iterm2_tab_color_reset resets the color of iTerm2's current tab back to default.

For shell integration features see the official documentation.

Contributors