https://github.com/decayofmind/zsh-iterm2-utilities

Lightweight ZSH plugin (Zinit) to sync iTerm2 utilities
https://github.com/decayofmind/zsh-iterm2-utilities

iterm2 iterm2-utilities proxy sync zinit zplugin zsh

Last synced: 3 months ago
JSON representation

Lightweight ZSH plugin (Zinit) to sync iTerm2 utilities

• Host: GitHub
• URL: https://github.com/decayofmind/zsh-iterm2-utilities
• Owner: decayofmind
• License: mit
• Archived: true
• Created: 2019-09-16T10:02:26.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2022-01-02T21:14:33.000Z (almost 3 years ago)
• Last Synced: 2024-01-29T13:16:15.766Z (9 months ago)
• Topics: iterm2, iterm2-utilities, proxy, sync, zinit, zplugin, zsh
• Language: Shell
• Homepage:
• Size: 14.6 KB
• Stars: 6
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-zsh-plugins - iterm2-utilities - Helps download various iTerm2 utilities and lets you omit cloning of the whole iterm2-website repository or relying on other repos which may be out of sync. (Plugins / Zinit (née zplugin))

README

        
# zsh-iterm2-utilities

---

**OBSOLETE AND ARCHIVED!**

The author of iTerm2 has moved shell integration to it's own [smaller repo](https://github.com/gnachman/iTerm2-shell-integration),

so this plugin is not needed anymore.

If you're using [Zinit](https://github.com/zdharma-continuum/zinit) you can achieve same results with the following snippet

```bash

zinit ice depth"1" \

  atload'!PATH+=:$(pwd)/utilities'\

  pick"shell_integration/zsh" if"[[ $+ITERM_PROFILE ]]"

zinit load gnachman/iTerm2-shell-integration

```

or better with [zinit-annex-bin-gem-node](https://github.com/zdharma-continuum/zinit-annex-bin-gem-node)

```bash

zinit ice depth"1" \

  pick"shell_integration/zsh" \

  sbin"utilities/*" if"[[ $+ITERM_PROFILE ]]"

zinit load gnachman/iTerm2-shell-integration

```

---

Simple, but smart ZSH plugin, helping to download various iTerm2 utilities.

The plugin allows to omit clonning of the whole iterm2-website repository or

relying to other repos, where those utilities may be out of sync.

This project utilizes GitHub actions to poll the original iterm2-website repo daily,

then it takes sha256 checksum of all scripts in utilities directory and commits

to this repository.

So, if utilities in iterm2-website master are updated, this repo gets updated to.

Zplugin allows to execute a special command at pull and clone (see snippet below),

the plugin is using that opportunity to download all the utilities.

At ZSH init, only `path` will be extended.

## Zinit (former Zplugin)

```

zinit ice as"command" pick"bin/*" atclone'./_utils/download_files.sh' \

  atpull'%atclone' if"[[ $+ITERM_PROFILE ]]"

zinit light decayofmind/zsh-iterm2-utilities

# functions

zinit snippet 'https://raw.githubusercontent.com/gnachman/iTerm2-shell-integration/main/shell_integration/zsh'

```