From 1132aa57102d41926b80173b2df211582dceb00e Mon Sep 17 00:00:00 2001
From: Guangxiong Lin <hi@gxlin.org>
Date: Wed, 26 Oct 2022 16:47:09 +0800
Subject: Add README

---
 README.md | 40 ++++++++++++++++++++++++++++++++++++++++
 1 file changed, 40 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..4088c73
--- /dev/null
+++ b/README.md
@@ -0,0 +1,40 @@
+# pass-login
+
+A [pass](https://www.passwordstore.org/) extension for extracting usernames.
+
+The extension looks for the following fields by order:
+- The second column in any line beginning with `login:`, `Login:`,
+  `Username:`, `username:`.
+- The path of the pass file.
+
+## Usage
+
+```
+Usage:
+    pass login [--clip,-c] pass-name
+        Show existing username and optionally put it on the clipboard.
+        If put on the clipboard, it will be cleared in 45 seconds.
+    pass help
+        Show this text.
+
+More information may be found in the pass-login(1) man page.
+```
+
+## Installation
+
+### Manually
+
+```bash
+git clone https://github.com/igxlin/pass-login.git
+cd pass-login
+sudo make install
+```
+
+### macOS
+
+Homebrew:
+
+```bash
+brew tap igxlin/tap
+brew install pass-login
+```
-- 
cgit v1.2.3