3 files changed, 77 insertions(+), 2 deletions(-)

M Cargo.lock
M Cargo.toml
A README.txt

@@ 1028,7 1028,7 @@ dependencies = [
 
 [[package]]
 name = "sage"
-version = "0.1.0"
+version = "0.1.1"
 dependencies = [
  "age",
  "anyhow",

@@ 1,6 1,6 @@
 [package]
 name = "sage"
-version = "0.1.0"
+version = "0.1.1"
 edition = "2024"
 license = "AGPL-3.0-only"
 description = "A simple wrapper for `age` to add a named identity system."

@@ 0,0 1,75 @@
+sage - simple age wrapper for named identities
+
+USAGE:
+    sage [OPTIONS] [SUBCOMMAND]
+    sage [--encrypt] (-r RECIPIENT | -R PATH)... [--armor] [-o OUTPUT] [INPUT]
+    sage [--encrypt] --passphrase [--armor] [-o OUTPUT] [INPUT]
+    sage --decrypt [-i PATH]... [-o OUTPUT] [INPUT]
+
+OPTIONS:
+    -h, --help                  Prints help information
+    -D, --database <FILE>       Set the database file (default {CONFIGFILE})
+
+    -v, --verbose               Enable debug logging
+    -e, --encrypt               Encrypt the input to the output. Default if omitted.
+    -d, --decrypt               Decrypt the input to the output.
+    -o, --output OUTPUT         Write the result to the file at path OUTPUT.
+    -a, --armor                 Encrypt to a PEM encoded format.
+    -p, --passphrase            Encrypt with a passphrase.
+    -r, --recipient RECIPIENT   Encrypt to the specified RECIPIENT. Can be repeated.
+    -R, --recipients-file PATH  Encrypt to the recipients listed at PATH. Can be repeated.
+    -i, --identity IDENTITY     Use the specified identity. Can be repeated.
+
+INPUT defaults to standard input, and OUTPUT defaults to standard output.
+If OUTPUT exists, it will be overwritten.
+
+RECIPIENT can be an age public key generate by age-keygen (\"age1...\")
+an SSH public key (\"ssh-ed25519 AAAA...\", \"ssh-rsa AAAA...\"), OR
+a fuzzy search term to use the database to locate a key.
+
+Recipient files contain one or more recipients, one per line. Empty lines
+and lines starting with \"#\" are ignored as comments. \"-\" may be uised to
+read recipients from standard input.
+
+An IDENTITY may either be a fuzzy search term to search the database, or
+an identity file.
+
+Identity files contain one or more secret keys (\"AGE-SECRET-KEY-1...\"),
+one per line, or an SSH key. Empty lines and lines starting with \"#\" are
+ignored as comments. Passphrase encrypted age files can be used as
+identity files. Multiple key files can be provided, and any unused ones
+will be ignored. \"-\" may be used to read identities from standard input.
+
+When --encrypt is specified explicitly, -i can also be used to encrypt to an
+identity file symmetrically, instead or in addition to normal recipients.
+
+If an identity is omitted and only one local identity exists in the database,
+it will be chosen automatically.
+
+SUBCOMMANDS:
+
+create-id <name> <email>
+    Create a new local identity in the database.
+    <name>      Name for the new identity
+    <email>     Email of the new identity
+
+ls [OPTIONS]
+    List keys in the database
+    OPTIONS:
+
+    -l, --local     Show only local (your) keys
+    -p, --peer      Show only peer (other's) keys
+    -f, --full      List full public keys instead of key IDs
+
+show [OPTIONS] <search term>
+    Search the database (fuzzy) and show a specific key
+
+    OPTIONS:
+    -e, --expose-secret     Output the secret key, if it is a local key
+
+import [OPTIONS] <key>
+    Imports the provided key into the database.
+    If the keyid already exists, it will do nothing.
+
+    OPTIONS:
+    -i, --insert-anyway     Insert even if a matching identity is already present<
\ No newline at end of file