feat: allow optional tagging of address book entries

Sponsored-by: author

1 files changed, 15 insertions, 0 deletions

diff --git a/clab.md b/clab.md
index b437cbc..de09758 100644
--- a/clab.md
+++ b/clab.md
@@ -67,6 +67,7 @@ then stdout is exactly "clab found matches:\nalice@example.com\tAlice Atherthon\
 - name: Alice Atherthon
   email:
     work: alice@example.com
+  tags: [co-worker]
   last_checked: 2021-09
 - name: Bob Bobbington
   email:
@@ -75,6 +76,20 @@ then stdout is exactly "clab found matches:\nalice@example.com\tAlice Atherthon\
 ~~~
 
 
+# Search by tag
+
+This scenario verifies that `clab` can find entries based on tags.
+
+~~~scenario
+given an installed clab
+given file .local/share/clab/address-book.yaml from address-book.yaml
+
+when I run clab tagged co-worker
+then command is successful
+then stdout contains "Alice Atherthon"
+then stdout doesn't contain "Bob"
+~~~
+
 # Full text search
 
 This scenario verifies that `clab` does a full text search.