STS2 Run Advisor

A single-file, browser-based strategy dashboard for Slay the Spire 2. It reads your live run state and gives real-time card-reward ratings, archetype detection, and build advice while you play.

The Run Advisor has two halves — you need both running: (1) the STS2 AI Agent mod installed and running in-game (it serves the local HTTP API), and (2) this dashboard open in a browser. The mod provides the data; this repo is the analysis UI on top of it. Neither half does anything useful on its own.

What this project is (and is not)

This repo is just the dashboard — one self-contained STS2-Run-Advisor.html file. All of the card-scoring, archetype-detection, and advice logic is my own.

The dashboard is an HTTP client. It does not read the game's memory or hook into the game itself. Instead it polls a small local API:

GET http://127.0.0.1:8080/state              → current run / deck / rewards
GET http://127.0.0.1:8080/image-cache/status → card-art cache status

That API is exposed by the STS2 AI Agent mod, a separate project. The mod is what actually talks to the game and serves the JSON this dashboard consumes:

• Upstream mod: CharTyr/STS2-Agent — the original mod + MCP server that exposes Slay the Spire 2's game state over a local HTTP API. Full credit for the game-integration layer goes to CharTyr.
• My fork (with the Run Advisor and related changes): Talnerith/STS2-Advisor.

So: the mod provides the data; this repo provides the analysis UI on top of it.

You do NOT need the rest of the mod repo here

To run this dashboard you only need the mod installed and running in-game — you do not need to copy any of the mod's source into this repo. From the STS2-Agent / STS2-Advisor project, none of the following are required here:

• STS2AIAgent/ — the C# Godot mod source (you install the built mod, not its source)
• mcp_server/ — the Python MCP server (a separate AI-agent integration this UI doesn't use)
• build/, scripts/, tools/, extraction/, skills/, docs/ — build/tooling/asset pipeline for the mod

The only runtime contract between this repo and that project is the HTTP API above.

Tech stack

• Plain HTML / CSS / JavaScript — one file, no build step, no dependencies
• Reads the mod's local HTTP API via fetch

Key features

• Card-reward scoring — pick / skip / consider ratings for each reward
• Archetype detection — infers your build direction (Strength, Exhaust, Poison, Shiv, Focus, etc.)
• Deck-synergy analysis — scores cards against the deck you're actually building
• Curse / removal prompts — flags cards to remove at the next opportunity
• Live updates — polls the running mod, no manual refresh

Screenshots

Setup

1. Install and run the STS2 AI Agent mod so the local API is live at http://127.0.0.1:8080 — follow the install steps in CharTyr/STS2-Agent (or my fork, Talnerith/STS2-Advisor).
2. Start a run in Slay the Spire 2.
3. Open STS2-Run-Advisor.html in any modern browser. It will connect to the local API and start advising. If it shows a connection error, confirm the mod is running and reachable at 127.0.0.1:8080.

License

MIT — this dashboard is my own work. It communicates with the mod only over HTTP and contains none of the mod's code, so it is licensed independently of the upstream mod's license.