MTG EDH Deck Manager

Command-line toolkit for managing Magic: The Gathering Commander (EDH) decks using the Scryfall API.

Installation

git clone <repo-url>
cd Decks

# Install git hook for auto-updating docs
cp scripts/pre-commit .git/hooks/pre-commit
chmod +x .git/hooks/pre-commit

No dependencies required - pure Python 3 standard library.

Usage

Hydrate a Collection

Fetch card data from Scryfall for a decklist:

python hydrate.py hydrate collection/decklist.txt -o collection_hydrated/ -c card_cache.json

Create a New Deck

python hydrate.py new my_deck

Analyze Decks

Find upgrade options from your collection:

python scripts/analyze_decks.py --collection collection_hydrated/deck.json --deck-dir decks/

Find Synergies

Search for cards by keywords, colors, and type:

# Find landfall cards in Simic colors
python scripts/find_synergies.py --collection collection_hydrated/deck.json --colors U G --keywords landfall

# Find Bird creatures in Bant colors
python scripts/find_synergies.py --collection collection_hydrated/deck.json --colors U G W --creature-type Bird

# Find instants with CMC 2 or less
python scripts/find_synergies.py --collection collection_hydrated/deck.json --type instant --cmc-max 2

Generate Reports

python scripts/deck_report.py --collection collection_hydrated/deck.json --decks-dir decks/ --output report.md

Decks

Deck	Colors	Commander	Archetype
Choco	UGW	Choco, Seeker of Paradise	Bird Tribal Landfall
Hazel	BG	Hazel of the Rootbloom	Golgari Aristocrats
Palamecia	UR	The Emperor of Palamecia // The Lord Master of Hell	Izzet Self-Mill Storm
Yshtola	UBW	Y'shtola, Night's Blessed	Esper Stax Drain

Workflow

Import - Place text decklists in collection/
Hydrate - Run hydrate.py to fetch Scryfall data → collection_hydrated/
Define - Create deck JSON files in decks/
Analyze - Run analyze_decks.py to find upgrade options
Report - Use deck_report.py for markdown summaries

Collection Stats

Total cards: 1209
Unique cards: 866
By type:
- Artifacts: 84
- Creatures: 390
- Enchantments: 63
- Instants: 124
- Lands: 97
- Planeswalkers: 2
- Sorceries: 105

This file is auto-generated. Edit docs/templates/README.template.md instead.

2.4 KiB Raw Blame History