wulfgarpro / history-sync

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

Home Page:https://www.wulfgar.pro/synchronising-zsh-history-over-the-internet-with-oh-my-zsh-and-history-sync/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

history-sync

history-sync

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

Installation

sudo apt install gpg git
git clone git@github.com:wulfgarpro/history-sync.git
cp -r history-sync ~/.oh-my-zsh/plugins

Then open .zshrc file and append history-sync to the plugin line:

plugins=(... history-sync)

And finally, reload zsh:

zsh

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
  2. 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:

  • ZSH_HISTORY_FILE: your zsh_history file location
  • ZSH_HISTORY_PROJ: your git project for housing your zsh_history file
  • ZSH_HISTORY_FILE_ENC: your encrypted zsh_history file location
  • ZSH_HISTORY_COMMIT_MSG: your default message when pushing to $ZSH_HISTORY_PROJ

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}"
ZSH_HISTORY_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

About

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

https://www.wulfgar.pro/synchronising-zsh-history-over-the-internet-with-oh-my-zsh-and-history-sync/

License:MIT License


Languages

Language:Shell 95.5%Language:Dockerfile 4.5%