About
cEDH AI is a systems and research project building a fully deterministic Magic: The Gathering rules engine for Competitive Commander (cEDH).
It is not a consumer product.
It is a platform.
The engine models the Comprehensive Rules explicitly, covering turn structure, priority, the stack, state-based actions, continuous effects across all seven dependency layers, replacement effects, triggered and activated abilities, and Commander-specific rules. Cards are not hardcoded. They are compiled from Oracle text into structured JSON that the engine evaluates deterministically.
The long-term goal is a stable game API that AI agents, simulators, and research tools can consume headlessly, with no UI required. A React frontend exists for inspection and private playtesting, not as the primary interface.
Current State
- 6,100+ tests across the engine and rules layer
- 470 hand-curated card definitions with 50+ LLM auto-compiled cards as fallback
- Six AI agents: Random, Simple, Heuristic, Evaluation, Hybrid, and MCTS with combo detection
- Multiplayer lobby system with WebSocket real-time updates supporting up to 4 players
- Full mana system including hybrid and Phyrexian costs, modal selections, and library search
- React frontend with board visualization, targeting, combat declaration, and mulligan UI
This is a private alpha.
Rules correctness is the top priority.
