relicario/user_docs/organizing.md

Organizing your vault: groups, tags, favorites, and search

This page covers how to keep your vault tidy as it grows — sorting items into groups, tagging them for cross-cutting labels, marking favorites, and finding things quickly.

---

Groups — one folder-like label per item

A group is a single label that acts like a folder. Every item can belong to at most one group. Use groups for broad categories (a room in the house, a project, a person in the family).

Set a group when adding an item:

relicario add login --title "Home router" --username admin --group Home
relicario add card --title "Visa credit" --group Finance

Change a group on an existing item:

Run relicario edit <title-or-id> and, when prompted for the group field, type the new value (or press Enter to keep the current one).

List items in a group:

relicario list --group Home
relicario list --group Finance

Group names are case-sensitive, so be consistent — Home and home are different groups.

---

Tags — multiple labels per item

Tags let you attach several labels to one item — useful when a single item fits more than one category. A login for your bank's app might belong to the Finance group and also carry tags mobile and 2fa-enabled.

Set tags when adding an item (comma-separated, no spaces around commas):

relicario add login --title "Bank mobile app" \
    --username me@example.com \
    --group Finance \
    --tags mobile,2fa-enabled

Change tags on an existing item:

Run relicario edit <title-or-id> and update the tags field when prompted.

Filter by tag:

relicario list --tag mobile
relicario list --tag 2fa-enabled

Only one tag at a time can be passed to --tag, but you can combine tag filtering with group and type filters (see Combining filters below).

---

Favorites — quick-access marker for login items

Login items support a --favorite flag. Mark an item as a favorite when you add it:

relicario add login --title "Gmail" --username me@example.com --favorite

This is a quick-access marker — it shows up in the browser extension's favorites view so your most-used logins are always one click away.

To toggle a favorite on an existing login, run relicario edit <title-or-id> and update the favorite field when prompted.

---

Finding things

Find by title substring — relicario get

relicario get accepts a title substring (case-insensitive) or an exact item id:

relicario get bank         # finds any item whose title contains "bank"
relicario get a3f2c1      # finds the item with that id

Secrets are masked by default. Pass --show to reveal them, or --copy to copy the primary secret (Login password, Card number, etc.) to the clipboard — it clears automatically after 30 seconds.

Filter the full list — relicario list

relicario list prints every item. Narrow it down with flags:

Flag	What it filters
--type <TYPE>	Item type: login, secure-note, identity, card, key, document, totp
--group <GROUP>	Items in that group
--tag <TAG>	Items carrying that tag
--trashed	Trashed (soft-deleted) items only

Combining filters

All filters can be combined in one command:

# All login items in the Finance group tagged "2fa-enabled"
relicario list --type login --group Finance --tag 2fa-enabled

# Every trashed item in the Work group
relicario list --group Work --trashed

---

A suggested scheme (non-prescriptive)

There is no one right answer, but here is a pattern that works well for a household or small team:

Groups → broad areas of life. Think of them like drawers:

• Home — router, smart devices, alarm panel
• Finance — bank accounts, investment logins, card numbers
• Work — corporate VPN, project tools, SSH keys
• Personal — social accounts, streaming services, email

Tags → cross-cutting traits that apply across groups:

• 2fa-enabled — logins that have TOTP set up
• shared — items you share with a family member
• critical — accounts you would be in serious trouble losing

Favorites → your daily drivers. Mark the five or ten logins you open every day. They surface at the top in the extension so you do not have to search.

This keeps groups stable (you rarely add a new drawer) while tags stay flexible (add new ones whenever a new trait comes up).

---

Shell-completion tip

If you build the optional shell completions, --group autocompletes from a local cache that Relicario maintains. Run:

relicario completions bash > /etc/bash_completion.d/relicario   # bash
relicario completions zsh > ~/.zfunc/_relicario                  # zsh

After that, pressing Tab after --group suggests your existing group names.

---

Next: Sync & backup