# README
enpass-cli
A commandline utility for the Enpass password manager.
Installation
Go get yourself a compiled binary from the releases page.
CLI Usage
$ # set an alias to easily reuse
$ alias enp="enpasscli -vault=/my-vault-dir/ -sort"
$ # list anything containing 'twitter' (without password)
$ enp list twitter
$ # show passwords of 'enpass.com'
$ enp show enpass.com
$ # copy password of 'reddit.com' entry to clipboard
$ enp copy reddit.com
$ # print password of 'github.com' to stdout, useful for scripting
$ password=$(enp pass github.com)
Commands
Name | Description |
---|---|
list FILTER | List vault entries matching FILTER without password |
show FILTER | List vault entries matching FILTER with password |
copy FILTER | Copy the password of a vault entry matching FILTER to the clipboard |
pass FILTER | Print the password of a vaulty entry matching FILTER to stdout |
dryrun | Opens the vault without reading anything from it |
version | Print the version |
help | Print the help text |
Flags
Name | Description |
---|---|
-vault=PATH | Path to your Enpass vault |
-keyfile=PATH | Path to your Enpass vault keyfile |
-type=TYPE | The type of your card (password, ...) |
-log=LEVEL | The log level from debug (5) to error (1) |
-nonInteractive | Disable prompts and fail instead |
-pin | Enable Quick Unlock using a PIN |
-and | Combines filters with AND instead of default OR |
-sort | Sort the output by title and username of the list and show command |
-trashed | Show trashed items in the list and show command |
-clipboardPrimary | Use primary X selection instead of clipboard for the copy command |
Development
# to run it from code
% go run ./cmd/... -vault=foo list
# to build it yourself
% make build
% ./enpass-cli -vault=foo list
Testing Code
$ go test -v $(go list ./... | grep -v /vendor/)
Using the library
See the documentation on pkg.go.dev.