collection

Interactively manage a collection of cards. Alias: collect.

Usage

./ritual collection

No arguments or options — the command launches a fully interactive session.

The collection manager supports two entry modes that you can toggle between during a session:

Autocomplete-driven card name entry. Type a card name and select from suggestions.

Session Filters — Configure default set codes, finish, and condition via the ⚙️ Configure Session Filters menu option. When set, these defaults are applied automatically to each card without prompting.
Force Prompts — Append ! to a card name to override finish and condition session filters for that entry, forcing the prompts to appear regardless of filter settings.
Edit Last Card — Re-enter the most recently added card with forced prompts, useful for correcting mistakes.

Look up cards by collector number within one or more loaded sets.

Set Management — Add, remove, and switch between multiple active set codes via the 📦 Manage Set Codes menu.
Autocomplete — Type a collector number prefix to filter the card list for the active set.

Each card entry is written to a markdown collection file in the collections/ directory:

- Card Name (SET:CN) [finish] [condition]

For example:

- Sol Ring (C19:221) [foil] [NM]
- Lightning Bolt (LEA:161)

Non-foil finish and no-preference condition are omitted for brevity.

Start the collection manager:

./ritual collection

Or use the alias:

./ritual collect