Cli Anything Slay The Spire Ii
- 349 installs
- 46.6k repo stars
- Updated August 3, 2026
- hkuds/cli-anything
cli-anything-slay-the-spire-ii is a CLI tool that controls Slay the Spire II via a local bridge mod HTTP API for developers who need automated playtesting and agent-driven game interaction.
About
cli-anything-slay-the-spire-ii is a stateful command-line interface for developers who want to control the real Slay the Spire II game through a local bridge mod. The tool reads normalized game state and sends action commands for combat, navigation, rewards, and menu management by calling a local HTTP API exposed by the `STS2_Bridge` mod. Developers reach for cli-anything-slay-the-spire-ii when building bot playtest loops, validating balance changes, or running agent-driven interaction research against the actual game client rather than a simulator. cli-anything-slay-the-spire-ii fits workflows where reproducible runs, scripted actions, and state introspection are needed to support tuning and regression testing of gameplay behavior.
- Slay the Spire II CLI bridge
- Automated playtesting hooks
- Game state inspection
- Agent-driven interaction
- cli-anything game adapter
Cli Anything Slay The Spire Ii by the numbers
- 349 all-time installs (skills.sh)
- +13 installs in the week ending Aug 2, 2026 (Skillselion tracking)
- Ranked #63 of 247 Game Development skills by installs in the Skillselion catalog
- Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-slay-the-spire-iiAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 349 |
|---|---|
| repo stars | ★ 46.6k |
| Last updated | August 3, 2026 |
| Repository | hkuds/cli-anything ↗ |
How do I automate Slay the Spire II playtests?
Query and drive Slay the Spire II game state through CLI hooks for bot playtesting, balance checks, and agent-driven game interaction research.
Who is it for?
Developers and researchers who need automated control of the live Slay the Spire II client for testing and balance work.
Skip if: Developers who need a generic HTTP mock server or web API testing tool.
When should I use this skill?
Trigger cli-anything-slay-the-spire-ii when a workflow needs scripted game actions and state reads via a local mod bridge.
What you get
A controllable playtest loop with normalized game state reads and action command execution.
- CLI-driven playtest runs
- Normalized game state snapshots
By the numbers
- The documented local API endpoint is localhost:15526.
Files
cli-anything-slay-the-spire-ii
A stateful command-line interface for controlling the real Slay the Spire 2 game through the local STS2_Bridge mod. The CLI reads normalized game state and sends action commands via a local HTTP API at localhost:15526.
Installation
This CLI requires a bridge mod that runs inside the game process. Both the CLI and the bridge are distributed from the same repository:
https://github.com/HKUDS/CLI-Anything1. Install the CLI
git clone https://github.com/HKUDS/CLI-Anything.git
cd CLI-Anything/slay_the_spire_ii/agent-harness
pip install -e .2. Build and install the bridge mod
The bridge mod is a .NET 9 plugin that must be compiled and installed into the game directory. Full instructions are in the repository README, but the short version is:
cd CLI-Anything/slay_the_spire_ii/agent-harness/bridge/plugin
./build.sh
cd ../install
./install_bridge.shIf the build script cannot auto-detect the game data directory, set STS2_GAME_DATA_DIR explicitly:
STS2_GAME_DATA_DIR="/path/to/data_sts2" ./build.sh3. Enable the mod and verify
Launch Slay the Spire 2 via Steam, enable the STS2_Bridge mod in the mod manager, then verify the connection:
cli-anything-sts2 stateIf this returns JSON, the CLI and bridge are connected.
Prerequisites:
- Python 3.10+
- Slay the Spire 2 (Steam) with
STS2_Bridgemod enabled .NET 9 SDK(only needed to build the bridge mod)
Usage
Basic Commands
# Read normalized game state (always start here)
cli-anything-sts2 state
# Start interactive REPL mode (default)
cli-anything-sts2
# Show all available commands
cli-anything-sts2 --helpCommand Groups
State Inspection
| Command | Description |
|---|---|
state | Normalized state with decision field |
raw-state | Raw bridge JSON |
Main Menu
| Command | Description |
|---|---|
continue-game | Continue a saved run |
start-game --character IRONCLAD --ascension 0 | Start a new run |
abandon-game | Abandon the current save |
return-to-main-menu | Return to menu from any screen |
Characters: IRONCLAD, SILENT, DEFECT, NECROBINDER, REGENT
Combat
| Command | Description |
|---|---|
play-card <index> [--target <enemy_id>] | Play a card from hand |
use-potion <slot> [--target <enemy_id>] | Use a potion |
end-turn | End the current turn |
Map & Room Flow
| Command | Description |
|---|---|
choose-map <index> | Select a map node |
proceed | Leave the current room |
Rewards
| Command | Description |
|---|---|
claim-reward <index> | Claim a combat reward |
pick-card-reward <index> | Pick a card reward |
skip-card-reward | Skip the card reward |
claim-treasure-relic <index> | Claim a treasure relic |
select-relic <index> | Select a relic |
skip-relic-selection | Skip relic selection |
Events & Rest Sites
| Command | Description |
|---|---|
event <index> | Choose an event option |
advance-dialogue | Advance dialogue-only events |
rest <index> | Choose a campfire action |
Shop
| Command | Description |
|---|---|
shop-buy <index> | Buy from the shop |
Card/Relic Selection Overlays
| Command | Description |
|---|---|
select-card <index> | Select a card in overlay |
confirm-selection | Confirm the current selection |
cancel-selection | Cancel the current selection |
combat-select-card <index> | Select a card during combat overlay |
combat-confirm-selection | Confirm combat card selection |
Raw Action
| Command | Description |
|---|---|
action <name> --kv key=value | Send a raw bridge action |
Decision States
The state command returns JSON with a decision field indicating the current game screen. Route your next command based on this value:
| Decision | Meaning | Typical Next Commands |
|---|---|---|
menu | Main menu | continue-game, start-game |
combat_play | In combat, your turn | play-card, use-potion, end-turn |
hand_select | Card selection overlay | combat-select-card, combat-confirm-selection |
map_select | Map node selection | choose-map |
game_over | Run ended | return-to-main-menu |
combat_rewards | Post-combat rewards | claim-reward, proceed |
card_reward | Card reward pick | pick-card-reward, skip-card-reward |
event_choice | Event screen | event, advance-dialogue |
rest_site | Campfire | rest |
shop | Shop screen | shop-buy, proceed |
card_select | Card selection screen | select-card, confirm-selection |
relic_select | Relic selection | select-relic, skip-relic-selection |
treasure | Treasure room | claim-treasure-relic, proceed |
Configuration
| Option | Default | Description |
|---|---|---|
--base-url | http://localhost:15526 | Bridge API URL |
--timeout | 10.0 | HTTP timeout in seconds |
For AI Agents
1. Always read `state` first to get the decision field 2. Re-read state after each action - indices and energy change during combat 3. Check return codes - 0 for success, non-zero for errors 4. Parse stdout for JSON output
Related skills
Godot Gdscript PatternsGenerate production-grade GDScript following Godot best practices for scene management, save systems, and performance.13.2k38.5k
Game EngineInstantly bootstrap a tilt-controlled 2D maze game using Phaser and device orientation.11.9k37.5k
Msw GeneralAdd a versatile set of general-purpose AI coding capabilities directly into Cursor, Claude Code, and similar agents.4.5k33
Game DeveloperGenerate clean ECS architecture, component patterns, and performant game systems that Claude or Cursor can expand into full Unity or custom engines.4.5k10.9kMsw DefaultplayerInstantly load a reliable default AI coding agent profile with proven prompts and behaviors.4.5k33Msw ScriptingCreate reusable, programmable agent behaviors and custom scripting flows that integrate directly with Claude, Cursor and other coding agents.4.5k33How it compares
Pick this when you need automation against a real game client; pick a simulator harness when you do not want mod or client dependencies.
FAQ
What does cli-anything-slay-the-spire-ii connect to?
cli-anything-slay-the-spire-ii connects to the `STS2_Bridge` mod running inside the Slay the Spire II game process. cli-anything-slay-the-spire-ii sends commands and reads state through a local HTTP API, enabling automation against the real client rather than a simulated environm
What endpoint does cli-anything-slay-the-spire-ii use?
cli-anything-slay-the-spire-ii uses a local HTTP API at localhost:15526 as described in the tool documentation. cli-anything-slay-the-spire-ii relies on the bridge mod exposing that endpoint so the CLI can issue combat and navigation commands and read normalized state.