https://github.com/antoinemartin/wsl2-ssh-pageant-oh-my-zsh-plugin
Oh My ZSH plugin to use your Yubikey stored GPG keys from WSL
https://github.com/antoinemartin/wsl2-ssh-pageant-oh-my-zsh-plugin
gpg oh-my-zsh oh-my-zsh-plugin wsl2 yubikey zsh zsh-plugins
Last synced: 7 months ago
JSON representation
Oh My ZSH plugin to use your Yubikey stored GPG keys from WSL
- Host: GitHub
- URL: https://github.com/antoinemartin/wsl2-ssh-pageant-oh-my-zsh-plugin
- Owner: antoinemartin
- License: apache-2.0
- Created: 2022-02-13T21:04:04.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2025-03-16T09:12:54.000Z (8 months ago)
- Last Synced: 2025-04-30T10:43:13.071Z (7 months ago)
- Topics: gpg, oh-my-zsh, oh-my-zsh-plugin, wsl2, yubikey, zsh, zsh-plugins
- Language: Shell
- Homepage:
- Size: 12.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-zsh-plugins - wsl2-ssh-pageant - Use your Yubikey stored GPG keys from WSL. This packages the instructions from [wsl2-ssh-pageant repo](https://github.com/BlackReloaded/wsl2-ssh-pageant) as a ZSH plugin. (Plugins / ZSH on Windows)
- fucking-awesome-zsh-plugins - wsl2-ssh-pageant - Use your Yubikey stored GPG keys from WSL. This packages the instructions from <b><code> 372⭐</code></b> <b><code> 72🍴</code></b> [wsl2-ssh-pageant repo](https://github.com/BlackReloaded/wsl2-ssh-pageant)) as a ZSH plugin. (Plugins / ZSH on Windows)
README
# wsl2-ssh-pageant-oh-my-zsh-plugin
[oh-my-zsh plugin](https://github.com/robbyrussell/oh-my-zsh) to use your
Yubikey stored GPG keys from WSL.
This plugin implements the instructions of the
[wsl2-ssh-pageant repo](https://github.com/BlackReloaded/wsl2-ssh-pageant) as a
oh-my-zsh plugin.
To create your certificate and keys, the most comprehensive guide is probably
the [YubiKey Guide](https://github.com/drduh/YubiKey-Guide) from drduh. In this
guide you will find information on how to backup properly your private keys.
However, the WSL part is for WSL 1.
[This other guide](https://jardazivny.medium.com/the-ultimate-guide-to-yubikey-on-wsl2-part-1-dce2ff8d7e45)
on Medium is specific to Windows and contains a section on WSL2.
This plugins avoids adding code to your `~/.zshrc` file when you're using
`oh-my-zsh` on WSL.
## Install
Create a new directory in `$ZSH_CUSTOM/plugins` called `wsl2-ssh-pageant` and
clone this repo into that directory. Note: it must be named `wsl2-ssh-pageant`
or oh-my-zsh won't recognize that it is a valid plugin directory.
```
git clone --depth 1 https://github.com/antoinemartin/wsl2-ssh-pageant-oh-my-zsh-plugin $ZSH_CUSTOM/plugins/wsl2-ssh-pageant
```
## Usage
Add `wsl2-ssh-pageant` to the `plugins=()` list in your `~/.zshrc` file and
you're done.