pass's Introduction

Password Store Distribution

This repository contains a copy of the password-store.sh application, along with bash completion, a couple of plugins and a simple wrapper.

This repository contains zero secrets, or passwords.

Motivation

I want to use the same plugins on all systems, without the need to have a complicated setup. So I created a simple wrapper-script pass to load the password-store.sh script, configuring plugins appropriately.

This allows me to clone this repository, and have everything working with one operation.

Plugins

The following plugins are included in the repository:

extensions/age.bash
- Show the age of all password-store entries, by looking at the git log.
- Written by me, licensed under the terms of the GPL-3.
extensions/env.bash
- Make passwords available as environmental variables, which is useful for scripting.
- Written by me, licensed under the terms of the GPL-3.
extensions/gen.bash
- Generate passwords via sysbox.
- Written by me, licensed under the terms of the GPL-3.
extensions/otp.bash
- 2FA support, via oauthtools.
- Written by Tad Fisher, licensed under the terms of the GPL-3.

Installation

I clone the repository beneath /opt/pass, and then configure my shell to use it:

if [ -d /opt/pass ]; then
    # Add to path.
    export PATH=/opt/pass:$PATH

    # source completion, bash-only.
    source /opt/pass/completion/pass.bash-completion
fi

Once that has been done things work as you'd expect: