* Opass
opass is a simple password database written in ocaml.  It uses gpg
for storing the db and all operation are performed in memory.  No tricks
are used to to ensure the security of this program.  It depends on being
run in a secure location, but since the data is stored on gpg it should
be safe to store in an insecure location.

Right now opass just does things I care about so don't expect it to work
well for you.

* Operations
In each operation a database is created if none exists

** Adding
#+BEGIN_QUOTE
    opass add
#+END_QUOTE

This adds an entry to the database. Duplicates are not allowed.
The database is copied to a .bak file prior to writing the contents
back out incase the write fails.

** Searching
#+BEGIN_QUOTE
    opass search <term>
#+END_QUOTE

Searches for a term.  The password or note's name, location, and username
are all searched case insenitively.  `opass search` will print the entire
db

** Editing
#+BEGIN_QUOTE
    opass edit <entry name>
#+END_QUOTE

Edits a single entry.  You can change all attributes about it, even
generating a new password.  The entry name must be the exact name.  Use
quotes if it contains spaces.

** Deleting
#+BEGIN_QUOTE
    opass del <entryname1> <entryname2> ...
#+END_QUOTE

Will confirm and delete all matching entry names.  The entry names must be exact
matches.  Use quotes if there are spaces in the name.

** Merging
#+BEGIN_QUOTE
    opass merge -t 1password -f /path/to/text/dump
#+END_QUOTE

This merges a 1Password exported file into opass.  1Password may have duplicates
and this will simply error in that case, more helpful debugging will be added
in the future.

** Generating random passwords
#+BEGIN_QUOTE
    opass password [-l length] [-c charset]
#+END_QUOTE

opass can be used to generate random passwords.  Valid value for charset are
`any`, `alpha`, `alphanum`.  Example:

#+BEGIN_QUOTE
    opass password -l 12
#+END_QUOTE

* Neat! But...

** Why should I use this over 1Password?

Maybe you shouldn't!  I wrote this because I wanted a solution with a CLI interface
and worked on Linux.  I think 1Password is a great product and I even paid for a
license, but I have come to value portability and control over my platform more.

** Why should I use this at all?

Maybe you shouldn't!  I wrote this for my own needs and it develops at that pace.
I am willing to handle feature requests as long as they are reasonable and correspond
to my own goals, but if you think the product is incomplete at this point and aren't
comfortable enough in Ocaml to fork it yourself then you probably shouldn't use opass.