Kill Tower Text Version

Kill Tower Text Version is a Python-first scaffold for a text-based implementation of Slay the Spire 2.

The current repository contains:

• a Python package layout under src/
• a Typer CLI entry point
• a runnable Textual launcher for Chinese single-player runs
• data schemas and loading utilities
• snapshot import and normalization script templates
• baseline docs for architecture, parity, combat flow, and TUI flow

Quick Start

python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -e .[dev]
kill-tower info
kill-tower run ui
kill-tower run play
kill-tower run auto

If your distro creates a .venv without pip, install to the user environment instead:

python3 -m pip install --user -e .[dev]
kill-tower info
kill-tower run play

kill-tower run play is the interactive manual mode: you choose cards, event branches, merchant purchases, and campfire rests.

kill-tower run auto and kill-tower run ui are auto-run preview tools.

Common Commands

kill-tower info
kill-tower data paths
kill-tower data init-manifest
kill-tower run ui
kill-tower run play
kill-tower run play --floors 3
kill-tower run play --character-id silent --full-act
kill-tower run auto --character-id silent --full-act
python scripts/smoke_run.py
python scripts/generate_unresolved_coverage_report.py 2026-04-09_build_unknown
python scripts/generate_transcript_goldens.py
pytest

Repository Layout

• docs/: architecture and delivery notes
• data/: raw imports, normalized snapshots, reports
• scripts/: import, normalization, diff, and smoke-run helpers
• src/kill_tower/: package source
• tests/: unit, integration, parity, regression, golden suites

Roadmap

The detailed roadmap lives in todo.md.