diff --git a/Plugins.md b/Plugins.md index 66aaadb..9ec6277 100644 --- a/Plugins.md +++ b/Plugins.md @@ -24,7 +24,7 @@ plugins=(rails git ruby) - [1password](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/1password): this plugin adds 1Password functionality to oh-my-zsh. - [aliases](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/aliases): with lots of 3rd-party amazing aliases installed, this plugin helps list the shortcuts that are currently available based on the plugins you have enabled. - [alias-finder](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/alias-finder): this plugin searches the defined aliases and outputs any that match the command inputted. This makes learning new aliases easier. -- [ansible](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/ansible): the `ansible plugin` adds several aliases for useful [ansible](https://docs.ansible.com/ansible/latest/index.html) commands and [aliases](#aliases). +- [ansible](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/ansible): the `ansible plugin` adds several aliases for useful [ansible](https://docs.ansible.com/ansible/latest/index.html) commands and [aliases](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/ansible#aliases). - [ant](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/ant): this plugin provides completion for [Ant](https://ant.apache.org/). - [apache2-macports](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/apache2-macports): enables aliases to control a local Apache2 installed via [MacPorts](https://www.macports.org/). - [arcanist](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/arcanist): this plugin adds many useful aliases for [arcanist](https://github.com/phacility/arcanist). @@ -56,20 +56,20 @@ plugins=(rails git ruby) - [catimg](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/catimg): plugin for displaying images on the terminal using the `catimg.sh` script provided by [posva](https://github.com/posva/catimg) - [celery](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/celery): this plugin provides completion for [Celery](http://www.celeryproject.org/). - [charm](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/charm): this plugin adds completion for the [charm](https://github.com/charmbracelet/charm) CLI. -- [chezmoi](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/chezmoi): ## Introduction +- [chezmoi](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/chezmoi): This plugin adds completion for [chezmoi](https://chezmoi.io/). - [chruby](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/chruby): this plugin loads [chruby](https://github.com/postmodern/chruby), a tool that changes the current Ruby version, and completion and a prompt function to display the Ruby version. Supports brew and manual installation of chruby. - [chucknorris](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/chucknorris): fortunes plugin for Chuck Norris for Oh My Zsh. Perfectly suitable as MOTD. - [cloudfoundry](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/cloudfoundry): this plugin is intended to offer a few simple aliases for regular users of the [Cloud Foundry Cli][1]. Most are just simple aliases that will save a bit of typing. Others include mini functions and or accept parameters. Take a look at the table below for details. - [codeclimate](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/codeclimate): this plugin adds autocompletion for the [`codeclimate` CLI](https://github.com/codeclimate/codeclimate). - [coffee](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/coffee): this plugin provides aliases for quickly compiling and previewing your coffeescript code. -- [colemak](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/colemak): this plugin remaps keys in `zsh`'s [`vi`-style navigation mode](http://zsh.sourceforge.net/Doc/Release/Zsh-Line-Editor.html#Keymaps) for a [Colemak](https://colemak.com/) keyboard layout, to match the QWERTY position: +- [colemak](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/colemak): this plugin remaps keys in `zsh`'s [`vi`-style navigation mode](https://zsh.sourceforge.io/Doc/Release/Zsh-Line-Editor.html#Keymaps) for a [Colemak](https://colemak.com/) keyboard layout, to match the QWERTY position: - [colored-man-pages](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/colored-man-pages): this plugin adds colors to man pages. - [colorize](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/colorize): with this plugin you can syntax-highlight file contents of over 300 supported languages and other text formats. - [command-not-found](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/command-not-found): this plugin uses the command-not-found package for zsh to provide suggested packages to be installed if a command cannot be found. - [common-aliases](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/common-aliases): this plugin creates helpful shortcut aliases for many commonly used commands. - [compleat](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/compleat): this plugin looks for [compleat](https://github.com/mbrubeck/compleat) and loads its completion. - [composer](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/composer): this plugin provides completion for [composer](https://getcomposer.org/), as well as aliases for frequent composer commands. It also adds Composer's global binaries to the PATH, using Composer if available. -- [conda](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/conda): the conda plugin provides [aliases](#aliases) for `conda`, usually installed via [anaconda](https://www.anaconda.com/) or [miniconda](https://docs.conda.io/en/latest/miniconda.html). +- [conda](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/conda): the conda plugin provides [aliases](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/conda#aliases) for `conda`, usually installed via [anaconda](https://www.anaconda.com/) or [miniconda](https://docs.conda.io/en/latest/miniconda.html). - [conda-env](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/conda-env): the plugin displays information of the created virtual container of conda and allows background theming. - [copybuffer](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/copybuffer): this plugin adds the ctrl-o keyboard shortcut to copy the current text in the command line to the system clipboard. - [copyfile](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/copyfile): puts the contents of a file in your system clipboard so you can paste it anywhere. @@ -77,7 +77,7 @@ plugins=(rails git ruby) - [cp](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/cp): this plugin defines a `cpv` function that uses `rsync` so that you get the features and security of this command. - [cpanm](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/cpanm): this plugin provides completion for [Cpanm](https://github.com/miyagawa/cpanminus) ([docs](https://metacpan.org/pod/App::cpanminus)). - [dash](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/dash): this plugin adds command line functionality for [Dash](https://kapeli.com/dash), an API Documentation Browser for macOS. This plugin requires Dash to be installed to work. -- [dbt](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/dbt): the `dbt plugin` adds several aliases for useful [dbt](https://docs.getdbt.com/) commands and [aliases](#aliases). +- [dbt](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/dbt): the `dbt plugin` adds several aliases for useful [dbt](https://docs.getdbt.com/) commands and [aliases](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/dbt#aliases). - [debian](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/debian): this plugin provides Debian-related aliases and functions for zsh. - [deno](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/deno): this plugin sets up completion and aliases for [Deno](https://deno.land). - [dircycle](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/dircycle): plugin for cycling through the directory stack @@ -123,7 +123,7 @@ plugins=(rails git ruby) - [gem](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/gem): this plugin adds completions and aliases for [Gem](https://rubygems.org/). The completions include the common `gem` subcommands as well as the installed gems in the current directory. - [genpass](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/genpass): this plugin provides three unique password generators for ZSH. Each generator has at least a 128-bit security margin and generates passwords from the cryptographically secure `/dev/urandom`. Each generator can also take an optional numeric argument to generate multiple passwords. - [gh](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/gh): this plugin adds completion for the [GitHub CLI](https://cli.github.com/). -- [git](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/git): the git plugin provides many [aliases](#aliases) and a few useful [functions](#functions). +- [git](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/git): the git plugin provides many [aliases](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/git#aliases) and a few useful [functions](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/git#functions). - [git-auto-fetch](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/git-auto-fetch): automatically fetches all changes from all remotes while you are working in a git-initialized directory. - [git-commit](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/git-commit): the git-commit plugin adds several [git aliases](https://www.git-scm.com/docs/git-config#Documentation/git-config.txt-alias) for [conventional commit](https://www.conventionalcommits.org/en/v1.0.0/#summary) messages. - [git-escape-magic](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/git-escape-magic): this plugin is copied from the original at https://github.com/knu/zsh-git-escape-magic. All credit for the functionality enabled by this plugin should go to @knu. @@ -134,7 +134,7 @@ plugins=(rails git ruby) - [github](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/github): this plugin supports working with GitHub from the command line. It provides a few things: - [git-hubflow](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/git-hubflow): this plugin adds completion for [HubFlow](https://datasift.github.io/gitflow/) (GitFlow for GitHub), as well as some aliases for common commands. HubFlow is a git extension to make it easy to use GitFlow with GitHub. Based on the original gitflow extension for git. - [gitignore](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/gitignore): this plugin enables you the use of [gitignore.io](https://www.toptal.com/developers/gitignore) from the command line. You need an active internet connection. -- [git-lfs](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/git-lfs): the git lfs plugin provides [aliases](#aliases) and [functions](#functions) for [git-lfs](https://github.com/git-lfs/git-lfs). +- [git-lfs](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/git-lfs): the git lfs plugin provides [aliases](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/git-lfs#aliases) and [functions](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/git-lfs#functions) for [git-lfs](https://github.com/git-lfs/git-lfs). - [git-prompt](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/git-prompt): A `zsh` prompt that displays information about the current git repository. In particular: the branch name, difference with remote branch, number of files staged or changed, etc. - [glassfish](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/glassfish): the glassfish plugin adds completion for the `asadmin` utility, a command to manage [Oracle GlassFish](https://docs.oracle.com/cd/E18930_01/html/821-2416/giobi.html) servers. - [globalias](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/globalias): expands all glob expressions, subcommands and aliases (including global). @@ -166,7 +166,7 @@ plugins=(rails git ruby) - [jake-node](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/jake-node): this plugin provides completion for [Jake](http://jakejs.com/). - [jenv](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/jenv): [jenv](https://www.jenv.be/) is a Java version manager similar to [rbenv](https://github.com/rbenv/rbenv) and [pyenv](https://github.com/yyuu/pyenv). - [jfrog](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/jfrog): this plugin provides completion for [JFrog CLI](https://github.com/jfrog/jfrog-cli). -- [jhbuild](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/jhbuild): this plugin adds some [JHBuild](https://developer.gnome.org/jhbuild/) aliases. +- [jhbuild](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/jhbuild): this plugin adds some [JHBuild](https://gnome.pages.gitlab.gnome.org/jhbuild/) aliases. - [jira](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/jira): this plugin provides command line tools for interacting with Atlassian's [JIRA](https://www.atlassian.com/software/jira) bug tracking software. - [jruby](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/jruby): this plugin adds aliases for [JRuby](https://www.jruby.org/). - [jsontools](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/jsontools): handy command line tools for dealing with json data. @@ -202,7 +202,7 @@ plugins=(rails git ruby) - [marked2](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/marked2): plugin for Marked 2, a previewer for Markdown files on Mac OS X - [marktext](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/marktext): plugin for MarkText, a previewer for Markdown files on Mac OS X - [mercurial](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/mercurial): this plugin adds some handy aliases for using Mercurial as well as a few utility and prompt functions that can be used in a theme. -- [meteor](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/meteor): the [meteor plugin](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/meteor) provides many [useful aliases](#aliases) as well as completion for the `meteor` command. +- [meteor](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/meteor): the [meteor plugin](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/meteor) provides many [useful aliases](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/meteor#aliases) as well as completion for the `meteor` command. - [microk8s](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/microk8s): this plugin provides completion and useful aliases for [MicroK8s](https://microk8s.io/). - [minikube](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/minikube): this plugin provides completion for [minikube](https://github.com/kubernetes/minikube). - [mise](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/mise): adds integration with [mise](https://github.com/jdx/mise) (formerly `rtx`), a runtime executor compatible with npm, nodenv, pyenv, etc. mise is written in rust and is very fast. 20x-200x faster than asdf. With that being said, mise is compatible with asdf plugins and .tool-versions files. It can be used as a drop-in replacement. @@ -212,7 +212,7 @@ plugins=(rails git ruby) - [mongocli](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/mongocli): the plugin adds several aliases for common [mongocli](https://docs.mongodb.com/mongocli/stable/) commands. - [mosh](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/mosh): this plugin allows SSH tab completion for [mosh](https://mosh.org/) hostnames. - [multipass](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/multipass): this plugin provides completion for [multipass](https://multipass.run), as well as aliases for multipass commands. -- [mvn](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/mvn): the mvn plugin provides many [useful aliases](#aliases) as well as completion for the [Apache Maven](https://maven.apache.org/) command (`mvn`). +- [mvn](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/mvn): the mvn plugin provides many [useful aliases](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/mvn#aliases) as well as completion for the [Apache Maven](https://maven.apache.org/) command (`mvn`). - [mysql-macports](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/mysql-macports): this plugin adds aliases for some of the commonly used [MySQL](https://www.mysql.com/) commands when installed using [MacPorts](https://www.macports.org/) on macOS. - [n98-magerun](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/n98-magerun): the swiss army knife for Magento developers, sysadmins and devops. The tool provides a huge set of well tested command line commands which save hours of work time. - [nanoc](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/nanoc): this plugin adds some aliases and autocompletion for common [Nanoc](https://nanoc.ws) commands. @@ -231,9 +231,9 @@ plugins=(rails git ruby) - [otp](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/otp): this plugin allows you to create one-time passwords using [`oathtool`](https://www.nongnu.org/oath-toolkit/man-oathtool.html), able to replace MFA devices. The oathtool key is kept in a GPG-encrypted file so the codes can only be generated by a user able to decrypt it. - [pass](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/pass): this plugin provides completion for the [pass](https://www.passwordstore.org/) password manager. - [paver](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/paver): this plugin adds completion for the `paver` command-line tool of [Paver](https://pythonhosted.org/Paver/). -- [pep8](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/pep8): this plugin adds completion for [pep8](https://pep8.readthedocs.io/en/release-1.7.x/#), a tool to check your Python code against some of the style conventions in [PEP 8](http://www.python.org/dev/peps/pep-0008/). +- [pep8](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/pep8): this plugin adds completion for [pep8](https://pep8.readthedocs.io/en/stable/), a tool to check your Python code against some of the style conventions in [PEP 8](https://peps.python.org/pep-0008/). - [percol](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/percol): provides some useful function to make [percol](https://github.com/mooz/percol) work with zsh history and the [jump plugin](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/jump), optionally. -- [per-directory-history](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/per-directory-history): this plugin adds per-directory history for zsh, as well as a global history, and the ability to toggle between them with a keyboard shortcut. This is a bundle of the [official plugin by @jimhester][5]. +- [per-directory-history](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/per-directory-history): this plugin adds per-directory history for zsh, as well as a global history, and the ability to toggle between them with a keyboard shortcut. This is a bundle of the [official plugin by @jimhester](https://github.com/jimhester/per-directory-history). - [perl](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/perl): this plugin adds [perl](https://www.perl.org/) useful aliases/functions. - [perms](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/perms): plugin to handle some unix filesystem permissions quickly. - [phing](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/phing): this plugin adds autocompletion for [`phing`](https://github.com/phingofficial/phing) targets. @@ -265,7 +265,7 @@ plugins=(rails git ruby) - [rbenv](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/rbenv): the primary job of this plugin is to provide `rbenv_prompt_info` which can be added to your theme to include Ruby version and gemset information into your prompt. - [rbfu](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/rbfu): this plugin starts [rbfu](https://github.com/hmans/rbfu), a minimal Ruby version manager, and adds some useful functions. - [rbw](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/rbw): this plugin adds completion for [rbw](https://github.com/doy/rbw), an unofficial CLI for [Bitwarden](https://bitwarden.com). -- [react-native](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/react-native): this plugin adds completion for [`react-native`](https://facebook.github.io/react-native/). It also defines a few [aliases](#aliases) for the commands more frequently used. +- [react-native](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/react-native): this plugin adds completion for [`react-native`](https://reactnative.dev/). It also defines a few [aliases](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/react-native#aliases) for the commands more frequently used. - [rebar](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/rebar): this plugin adds completions for the [rebar](https://www.rebar3.org/) Erlang build tool. - [redis-cli](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/redis-cli): this plugin adds [redis-cli](https://redis.io/topics/rediscli) completion, based off of Homebrew completion. - [repo](https://github.com/ohmyzsh/ohmyzsh/tree/master/plugins/repo): this plugin mainly adds some aliases and support for automatic completion for the [repo command line tool](https://code.google.com/p/git-repo/). @@ -383,5 +383,5 @@ plugins=(rails git ruby) - `ripgrep`: completion is already included when installed via package managers. - `rustup`: moved to the `rust` plugin. - `rtx`: moved to the `mise` plugin as [it was renamed](https://mise.jdx.dev/rtx.html). -- `vault`: use the [official autocompletion](https://www.vaultproject.io/docs/commands/index.html#autocompletion) instead. +- `vault`: use the [official autocompletion](https://developer.hashicorp.com/vault/docs/commands#enable-autocomplete) instead. - `zsh_reload`: functionality baked into the CLI with `omz reload`.