Handbook
Games examples & CLI cheatsheet
Set PYTHONPATH=src from the forge-lcdl repo root unless the package is installed editably.
Engine module CLI
python -m forge_lcdl.games.engine list-reference-games
python -m forge_lcdl.games.engine replay tests/games/fixtures/replay/tic_tac_toe_three_moves.json
python -m forge_lcdl.games.engine random-play nim --seed 7
python -m forge_lcdl.games.engine random-play connect_four_like --seed 2 --max-turns 200
examples/games/ scripts
| Script | Purpose |
|---|---|
examples/games/play_tic_tac_toe.py |
Small terminal UX over reference rules |
examples/games/play_connect_four_like.py |
Column-drop reference |
examples/games/replay_fixture.py |
Replay JSON fixtures (delegates to engine CLI helpers) |
examples/games/llm_advisor_fake.py |
Offline TaskRunner stub for game_move_explain |
Run:
PYTHONPATH=src python examples/games/play_tic_tac_toe.py
PYTHONPATH=src python examples/games/llm_advisor_fake.py
Further API reference: GAMES-ENGINE-API.md.