wanted-list

Interactively manage a wanted list of cards you’re looking for. Alias: wanted.

Usage

./ritual wanted-list [options]

Options

Flag	Description
-s, --sets <codes>	Filter by set codes (comma-separated, e.g., "FDN, SPG")
-f, --finish <finish>	Default finish: nonfoil, foil, or etched
--collector	Start in collector number mode
--allow-digital-only-cards	Include digital-only sets (e.g., Alchemy) in results

Digital-only sets (Alchemy sets, plus OM1) are filtered out by default since they have no paper printings.

Unlike the collection command, there is no --condition option — wanted lists track desired cards, not owned cards.

Card States

Each card on a wanted list exists in one of three states, which determines how pricing works:

State	Format	Pricing Behavior
Name only	- Card Name	Uses cheapest printing across all sets
Printing	- Card Name (SET:CN)	Uses cheapest finish of that exact printing
Fully specified	- Card Name (SET:CN) [finish]	Uses the exact printing and finish specified

When adding a card, you are prompted to choose the specificity level:

1. Name only (cheapest printing) — skips printing and finish selection entirely
2. Choose specific printing — enters the printing selection flow, then optionally choose a finish

If no printings can be found for a chosen card, it is added name-only rather than dropped.

Menu Options

The following options are available in the menu when no search text is typed:

Option	Description
💾 Save N change(s) (keep editing)	Write the file and changelog without leaving the session
🚪 Exit	Leave the session (asks to save, discard, or cancel when unsaved)
⚙️ Configure Session Filters	Adjust default set codes and finish
🔢 Switch to Collector Number Mode	Switch to collector number entry mode
📦 Manage Set Codes	Add, remove, or switch active sets (collector mode)
🔤 Switch to Name Mode	Switch back to name entry mode (collector mode)
🛠️ Switch to Edit Mode	Browse and edit the list’s existing cards (see Edit Mode)
➕ Add Another Copy	Append another copy of the last added card
📝 Add Note	Attach a note to the last added card
✏️ Edit Previous Card	Re-enter the last added card with forced prompts
↩️ Undo Last Add	Take back the most recently added card
↩️ Undo Last Edit	Revert the most recent edit-mode operation
📋 View Session Changes (N)	Review every change this session and optionally discard individual ones

The ↩️ Undo Last Add option appears only after you have added at least one card this session, and 📋 View Session Changes once the session has any change to show. The viewer lists everything done this session — adds, edits, and removals — and selecting an entry offers to discard just that change (see Reviewing Session Changes).

Saving

Like the admin Wanted List Editor, the session keeps every change in memory until you save: nothing is written to the list file as you add or edit cards. 💾 Save writes the file and appends the session changelog while you keep working (everything saved this way is committed — the undo and discard menus reset). Saving more than once in the same session folds each save’s changes into the session’s existing changelog entry (bumping its timestamp) instead of adding a new entry per save, so one editing session is always one changelog entry. 🚪 Exit leaves the session: with unsaved changes it opens a menu to Save and exit, Exit without saving (throws away all unsaved changes), or Cancel (keep editing). Pressing Esc/Ctrl-C at the main prompt behaves like 🚪 Exit.

Entry Modes

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

Name Mode (default)

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

• Session Filters — Configure default set codes and finish 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 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.

Collector Number Mode

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.

Edit Mode

🛠️ Switch to Edit Mode repurposes the search prompt: instead of the card database, it autocompletes over the list’s existing entries (rendered as their canonical lines). Selecting an entry opens an action menu:

Action	Description
🖼️ Change Printing	Re-pick the specificity: name-only, or a specific printing with optional finish
✨ Change Finish	Switch between nonfoil, foil, etched, or no preference (printed entries only)
📝 Edit Note	Edit or clear the entry’s note
🗑️ Remove	Delete the entry (asks for confirmation); releases its &N id

Every edit is undoable with ↩️ Undo Last Edit (a linear stack, newest first); undoing a removal restores the entry with its original &N id when the id has not been reused. Edits are folded into the session changelog with “latest wins” semantics — changing a card and then changing it back leaves no changelog entry. Removing a card that was added this session simply cancels the add. ➕ Switch to Add Mode returns to the regular add flow; you can toggle between the two modes freely within one session.

Reviewing Session Changes

📋 View Session Changes opens a picker listing every change made this session — ➕ adds, ✏️ field edits, and 🗑️ removals. Selecting an entry asks whether to discard that change, reverting just it while keeping the rest of the session intact:

• Discarding an add removes the card and frees its &N id; the remaining cards added this session keep dense, in-order ids (each later card slides down one, and the highest id returns to the pool). Because the re-pack renumbers ids, it also clears the edit-undo history.
• Discarding an edit or removal reverts that operation in place. When several changes touch the same card, they must be discarded newest-first — older ones are blocked until the newer change is discarded (the picker tells you which one).

Everything already saved with 💾 Save is committed and no longer appears in the viewer.

Output Format

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

- Card Name (SET:CN) [finish] {note} &N

For example:

- Sol Ring &1
- Lightning Bolt (LEA:161) &2
- Mana Crypt (2XM:270) [foil] &3
- Black Lotus (LEB:233) [nonfoil] {birthday present to self} &4

Any combination of set/collector number and finish can be omitted depending on the desired specificity level. The note is optional. The &N suffix is a persistent card ID used internally for change tracking and is auto-assigned.

Sections

A wanted list can be split into named sections using ## Section Name (H2) headers beneath the # Title. Cards are grouped under the header that precedes them; cards before the first header (or in a section-less file) belong to an implicit Main section that is written out explicitly the next time the file is saved.

# Wanted

## High Priority
- Queen Marchesa &1

## Someday
- Mana Crypt (2XM:270) [foil] &2

Section order is preserved as written. Cards added by this command go to the file’s last section. On the generated site, a wanted list with two or more sections defaults to grouping by section, and Section appears as a grouping option in the toolbar. Sections are managed from the admin Wanted List Editor; pricing commands ignore section headers.

Examples

Start the wanted list manager:

./ritual wanted-list

Pre-set finish:

./ritual wanted --finish foil

Start in collector number mode with sets pre-loaded:

./ritual wanted --collector --sets "FDN, SPG"

Filter by set in name mode:

./ritual wanted -s "MOM, ONE"