wuhao21

wuhao21 / sts2-cli

Public

Headless Slay the Spire 2 CLI — play the full game from a terminal.

16
0
69% credibility
Found Mar 23, 2026 at 16 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
C#
AI Summary

A terminal-based player for Slay the Spire 2 that runs the authentic game engine without graphics, enabling text adventures or AI experimentation.

How It Works

1
🔍 Discover Terminal Slay the Spire 2

You hear about a fun way to play the popular card game Slay the Spire 2 right in your terminal window, without needing graphics.

2
📥 Get and Set Up the Tool

Download the tool and let it automatically find your copy of the game on Steam and prepare everything with one simple run.

3
🚀 Start Your Adventure

Pick your favorite character like Ironclad or Silent, choose a seed for replayability, and launch the game in your terminal.

4
🗺️ Explore the Map and Battle

See the game map, choose paths to monsters or shops, play cards in combats, manage your deck, relics, and potions just like the real game.

5
Play Yourself or Let AI Take Over
👤
Interactive Play

Type numbers to pick cards, end turns, buy items, and feel the thrill of each decision.

🤖
Build or Use Bots

Send instructions to run full games automatically, perfect for training AI or testing strategies.

🏆 Complete Epic Runs

Finish acts, defeat bosses, and relive victories or learn from defeats with the exact same game rules and randomness.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 16 to 16 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is sts2-cli?

This C# CLI runs the full Slay the Spire 2 game engine headless in your terminal, pulling Steam DLLs for identical damage, card effects, enemy AI, relics, and RNG to the real Steam game. Play interactively via Python script with English/Chinese prompts—map navigation, combat card plays, shop buys—or pipe JSON commands over stdin/stdout for bots. Setup grabs game files automatically, supporting all five characters like Ironclad and Necrobinder.

Why is it gaining traction?

Unlike Slay the Spire 1 mods or approximations, it uses the actual engine for pixel-perfect simulation, making it a go-to for reproducible seeds and RL training in the headless gaming space—think Steam headless GitHub projects meets roguelike deckbuilders. The bilingual CLI shines for global devs, while the JSON protocol hooks AI builders tired of visual clients. Low barrier for C# and Python users experimenting with full game logic offline.

Who should use this?

RL researchers training Slay the Spire 2 agents need its faithful mechanics and JSON API for batch runs. Terminal gamers wanting distraction-free play—map views, deck lists, intent previews—without launching Steam. Chinese developers or bilingual teams get native localization for events, cards, and relics.

Verdict

Worth forking for AI prototypes or CLI marathons—JSON protocol delivers real value despite 16 stars and 0.7% credibility score signaling early maturity. Docs are solid, but brace for Steam/.NET setup tweaks; production bots demand your own hardening.

(198 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.