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

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

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

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

1.8 KiB Raw Blame History