SEKRIT(1)

NAME
sekrit - Secret files manager

SYNOPSIS
sekrit add key [value ...]
sekrit cp [-k] [key]
sekrit gen [-l length] [chars]
sekrit get key
sekrit has key
sekrit ls [keys ...]
sekrit rm [-f] key [key ...]

DESCRIPTION
sekrit is a small shell script for managing encrypted files. It leverages gpg2(1) to create and read encrypted files, and can generate random data to populate them.

Because of this, sekrit can be used as an account credentials manager, or as a general-purpose key-value store of encrypted information.

sekrit add key [value ...]
    Adds a value to key. value is inserted as is, without any extra modifications. If no value is specified on command line, add will read the value from standard input. add will fail if key already has a value.

sekrit cp [-k] key
    Decrypts the value associated with key and copies it to the clipboard with xclip(1). It removes the last newline unless -k is given.

sekrit gen [-l length] [chars]
    Outputs a randomly generated sequence. The generated sequence consist of characters chars. Defaults to +/0-9A-Za-z. If -l length is provided, the randomly generated sequence will be length characters long. Defaults to 44.

sekrit get key
    Decrypts the value associated with key and prints it to standard output. Fails if key doesn't have a value associated with it.

sekrit has key
    Returns success if key has a value associated with it. Fails otherwise.

sekrit ls [keys ...]
    For each key given as argument, list all the registered keys under that hierarchy. If no key is given, list all the registered keys.

sekrit rm [-f] key [key ...]
    Removes the file associated with each key. Asks for confirmation before removing each file, unless -f is given.

ENVIRONMENT

SEKRIT_DIR
    Secret files base directory. Defaults to ~/keep/sekrit.

SEKRIT_GPG_ID
    The recipient to whom encrypt the files. Must be set for sekrit to work.

EXIT STATUS

EXAMPLES
To use sekrit as an account credentials manager, you can run

    sekrit add accounts/example.com/user myuser
    sekrit gen accounts/example.com/pass

Then, to retrieve credentials to login as myuser in example.com you can run

    sekrit cp accounts/example.com/user
    sekrit cp accounts/example.com/pass

SEE ALSO
gpg2(1), xclip(1)

AUTHORS
Lucas

LICENSE
sekrit is in the public domain.

To the extent possible under law, the author(s) have dedicated all copyright and related and neighboring rights to this software to the public domain worldwide.

http://creativecommons.org/publicdomain/zero/1.0/