# `passrs`

A Rust implementation of zx2c4's `pass` password manager.

## How it works

This is written to solve the issue of *easy* sharing of passwords with non-technical users.

It stores `XChaCha20Poly1305` keys per directory, and stores the `XNonce` on line 1 of the password file, and the encrypted password on line 2.

`passrs` aims to be as close to compatible with `pass`, with few exceptions.

## Usage

```
passrs init [subfolder]
    Initialize a new password vault with a new key.
passrs [ls] [subfolder]
    List passwords.
passrs find pass-names...
    List passwords that match pass-names.
passrs [show] [--qrcode,-q] [--clip,-c] pass-name
    Show existing password. Optionally, show password as a QR code.
    Optionally, copy password to clipboard.
passrs grep [GREPOPTIONS] search-string
    Search for password files containing search-string when decrypted.
passrs insert [--echo,-e] [--force,-f] pass-name
    Insert new password. Optionally, echo the password back to the console
    during entry. Prompt before overwriting existing password unless forced.
passrs edit pass-name [--echo,-e]
    Insert a new password or edit an existing password.
passrs generate [--echo,-e] [--no-symbols,-n] [--force,-f] pass-name [pass-length]
    Generate a new password of pass-length (or 32 if unspecified) with optionally no symbols.
    Prompt before overwriting existing password unless forced.
    Optionally, echo the password back to the console.
passrs rm [--recursive,-r] [--force,-f] pass-name
    Remove existing password or directory, optionally forcefully
passrs mv [--force,-f] old-path new-path
    Renames or moves old-path to new-path, optionally forcefully, re-encrypting as it goes.
passrs cp [--force,-f] old-path new-path
    Copies old-path to new-path, optionally forcefully, re-encrypting as it goes.
passrs git git-command-args...
    If the password store is a git repository, execute a git command
    specified by git-command-args.
passrs help
    Show this help text.
passrs version
    Show version information.
```

## TODO

### Commands

- [x] Create vault ( `init [subfolder] [name]` )
- [x] Show passwords ( `[ls] [subfolder]` )
- [x] Find matching names ( `find pass-names...` )
  - [ ] Cleanup printing to account for no further entries that match
- [x] Show password ( `[show] pass-name` )
  - [x] Clipboard support ( `[--clip,-c]` )
  - [x] QRCode generation ( `[--qrcode,-q]` )
- [ ] Grep all plaintext passwords ( `grep [GREPOPTIONS] search-string` )
- [x] Insert password ( `insert pass-name` )
  - [x] Show password ( `[--echo,-e]` )
  - [x] Force overwrite ( `[--force,-f]` )
  - [ ] Multiline support ( `[--echo,-e | --multiline,-m]` )
    - [ ] Clip line numbers ( `--clip[=line-number],-c[=line-number]` )
- [x] Edit password ( `edit pass-name` )
- [x] Generate password ( `generate,gen` )
  - [x] Insert into storage ( `[pass-name]` )
  - [x] No special characters ( `[--no-symbols,-n]` )
  - [x] Clipboard support ( `[--clip,-c]` )
  - [ ] Inline support? ( `[--in-place,-i]` )
  - [x] Force overwrite ( `[--force,-f]` )
  - [x] Custom length ( `[--length,-l]` )
- [x] Delete password/path ( `rm pass-name` )
  - [x] Recursive ( `[--recursive,-r]` )
  - [x] Force overwrite ( `[--force,-f]` )
- [x] Move password ( `mv [--force,-f] old-path new-path` )
- [x] Copy password ( `cp [--force,-f] old-path new-path` )
- [ ] Git support ( `git git-command-args...` )
- [x] Show help ( `help` )
- [x] Show version ( `version` )
- [x] Multi-vault management (`vault`)
  - [x] List vaults (`list`)
  - [x] Select default vault (`set vault-name`)
  - [x] Rename vaults (`rename old-name new-name`)
  - [x] Delete vaults (`delete vault-name`)
  - [x] Move vaults (`mv vault-name new-path`)

### Refactoring

- [ ] Cleaner argument parsing
- [ ] Better usage on command parse error
- [ ] Unit tests
- [ ] Smarter configuration storage
- [x] Libify `passrs` with separate `bin` compilation