summaryrefslogtreecommitdiff
path: root/README.nfo
diff options
context:
space:
mode:
authorChristian Cleberg <[email protected]>2026-08-02 15:29:38 -0500
committerChristian Cleberg <[email protected]>2026-08-02 15:29:38 -0500
commit5aac7b3af4969ca0f43abb6047845a51acf56401 (patch)
treedb3320f9067683114f2714c8bd9d77760ba95ddb /README.nfo
parent1556817423d543f22e7b04a732648c7c5ddc13e3 (diff)
downloadyoshi-cli-main.tar.gz
yoshi-cli-main.tar.bz2
yoshi-cli-main.zip
convert readme to nfo; relicense to 0bsdHEADmain
Diffstat (limited to 'README.nfo')
-rw-r--r--README.nfo45
1 files changed, 45 insertions, 0 deletions
diff --git a/README.nfo b/README.nfo
new file mode 100644
index 0000000..3ac3d81
--- /dev/null
+++ b/README.nfo
@@ -0,0 +1,45 @@
+┌──────────────────────────────────────────────────────────────┐
+│ Y O S H I [ KRZ ] krz.sh │
+└──────────────────────────────────────────────────────────────┘
+
+WHAT
+ command-line password manager in python + sqlite3. manages accounts
+ and generates random passwords (ascii, min 8 chars) or xkcd-style
+ passphrases (min 3 words).
+
+INSTALL
+ pypi:
+
+ pipx install yoshi-cli
+
+ manual:
+
+ git clone REPO_URL
+ cd yoshi-cli
+ pipx install .
+
+USE
+ yoshi <COMMAND> <FLAG> <PARAMETER>
+
+ commands:
+ --help -h print the welcome message
+ --new -n create an account
+ --list -l list saved accounts
+ --edit -e edit an account (needs --uuid and --field)
+ --delete -d delete an account (needs --uuid)
+ --purge purge all accounts, delete the vault
+ --encrypt encrypt the vault (needs --generate or --keyfile)
+ --decrypt decrypt the vault (optional --keyfile)
+
+ flags:
+ --uuid -u account uuid
+ --field -f account field to edit
+ --generate -g generate a new key when encrypting
+ --keyfile -k path to a saved key file
+
+CONTRIBUTING
+ fork, add features, open a pull request.
+
+┌──────────────────────────────────────────────────────────────┐
+│ krz.sh │
+└──────────────────────────────────────────────────────────────┘