Discover, install, and configure shell plugins with Fig Plugin Store →
📜

History Sync

An oh-my-zsh plugin for GPG encrypted internet synchronised Zsh history, with Git.

wulfgarpro
|
210 stars
21 forks

history-sync

An Oh My Zsh plugin for GPG encrypted, Internet synchronized Zsh history using Git.

Usage

Before history-sync can be useful, you need two things:

  1. A hosted git repository, e.g. GitHub, Bitbucket
  • Ideally with ssh key access
  1. A configured gpg key pair for encrypting and decrypting your history file and the enrolled public keys of all the nodes in your web of trust

Once you have these things in place, it's just a matter of updating the needed environment variables to suit your configuration:

  • ZSHHISTORYFILE: your zsh_history file location
  • ZSHHISTORYPROJ: your git project for housing your zsh_history file
  • ZSHHISTORYFILEENC: your encrypted zshhistory file location
  • GITCOMMITMSG: your default message when pushing to $ZSHHISTORYPROJ

Which have the following defaults:

ZSH_HISTORY_FILE_NAME=".zsh_history"
ZSH_HISTORY_FILE="${HOME}/${ZSH_HISTORY_FILE_NAME}"
ZSH_HISTORY_PROJ="${HOME}/.zsh_history_proj"
ZSH_HISTORY_FILE_ENC_NAME="zsh_history"
ZSH_HISTORY_FILE_ENC="${ZSH_HISTORY_PROJ}/${ZSH_HISTORY_FILE_ENC_NAME}"
GIT_COMMIT_MSG="latest $(date)"

and running the commands:

# pull history
zhpl

# push history
zhps -r "John Brown" -r 876T3F78 -r ...

# pull and push history
zhsync

Demo

Check out the screen cast.

Licence

MIT @ James Fraser