Update docs and improve warning for plaintext
Fix home dir variable
Update README
Local notes, gpg-encrypted.
Simple CLI (similar to pass). Single-file installation, < 400 lines of code.
Run notes -h
for a full description of available commands.
Notes are stored in $NOTES_DIR
, which defaults to $HOME/.note-store
if it is unset.
Each note is stored as a file, with filename formatted as <name>.md.gpg
.
The contents of each note are never stored in plain text, only the filenames themselves.
When running note edit <note name>
, the associated note is decrypted using your default gpg key, then opened using your $EDITOR
.
You can optionally initialize a git repo within the notes directory by running notes git init
.
After that, every change to the store will be automatically tracked with a new commit to that repo.
You can also run any git other command from within that directory by simply prepending the notes
command, like so:
notes git <normal git commands + args>
For example, creating an encrypted backup of your entire notes storage is as easy as pushing to a remote repository (since notes are only stored in their encrypted form).
notes git push <remote>
When a note is opened for editing, it is first decrypted to plaintext using your GPG credentials. When you exit the editor, this plaintext file is usually deleted. However, there are situations when it will not be deleted.
For example, if your computer crashes while you are editing a note, the plaintext version of the note will be left on your disk (this actually happened to me once).
In order to reduce the risk of leaving plaintext lying around, a few precautions are taken:
notes list
command (alias notes
) will highlight any plaintext note files in RED..gitignore
with **/*.md
, so they will not be tracked by git.notes clean
will automatically clean up any plaintext files._PLAINTEXT
for clarity.