Cli Anything Slay The Spire Ii

by hkuds34f519533bc1No licenseListed Oct 8, 2026Updated Oct 8, 2026

Command-line interface for Slay the Spire 2 - Control the real game through a local bridge mod HTTP API. Reads normalized game state and sends action commands for combat, navigation, rewards, and menu management.

Instructions onlyOther

AI-generated overview

Controls the Slay the Spire 2 game through a local bridge mod HTTP API, reading state and sending actions.

What it does: Provides a stateful command-line interface that reads normalized game state from the STS2_Bridge mod over a local HTTP API and sends action commands back. It covers combat, map and room navigation, rewards, events, rest sites, shops, and card or relic selection overlays. The state command returns JSON with a decision field that indicates the current screen and suggests the next commands.
When to use it: Use it to drive a live Slay the Spire 2 run programmatically, such as automating combat turns, navigating the map, or claiming rewards. It suits agent workflows that need to inspect game state and issue the matching action for the current screen.
Requirements: Python 3.10+, Slay the Spire 2 on Steam with the STS2_Bridge mod enabled, and a local HTTP bridge at localhost:15526. Building the bridge mod requires the .NET 9 SDK and a game data directory. The skill ships instructions only, no scripts.

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:

1. Install the CLI

bash

git clone https://github.com/HKUDS/CLI-Anything.gitcd CLI-Anything/slay_the_spire_ii/agent-harnesspip install -e .

git clone https://github.com/HKUDS/CLI-Anything.gitcd CLI-Anything/slay_the_spire_ii/agent-harnesspip 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:

bash

cd CLI-Anything/slay_the_spire_ii/agent-harness/bridge/plugin./build.shcd ../install./install_bridge.sh

cd CLI-Anything/slay_the_spire_ii/agent-harness/bridge/plugin./build.shcd ../install./install_bridge.sh

If the build script cannot auto-detect the game data directory, set STS2_GAME_DATA_DIR explicitly:

3. 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:

If this returns JSON, the CLI and bridge are connected.

Prerequisites:

Python 3.10+
Slay the Spire 2 (Steam) with STS2_Bridge mod enabled
.NET 9 SDK (only needed to build the bridge mod)

Usage

Basic Commands

bash

# Read normalized game state (always start here)cli-anything-sts2 state
# Start interactive REPL mode (default)cli-anything-sts2
# Show all available commandscli-anything-sts2 --help

# Read normalized game state (always start here)cli-anything-sts2 state
# Start interactive REPL mode (default)cli-anything-sts2
# Show all available commandscli-anything-sts2 --help

Command Groups

State Inspection

Main Menu

Characters: IRONCLAD, SILENT, DEFECT, NECROBINDER, REGENT

Combat

Map & Room Flow

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

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

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

For AI Agents

Always read state first to get the decision field
Re-read state after each action - indices and energy change during combat
Check return codes - 0 for success, non-zero for errors
Parse stdout for JSON output

Source and attribution

Source:hkuds/cli-anythinginskills/cli-anything-slay-the-spire-iiat commit34f5195

License: No license

Content belongs to its original authors. SourceWeft indexes it from a public repository.

Report or request removal

More from hkuds/cli-anything

Cli Anything Zotero

hkuds

Agent-native CLI harness for inspecting and operating a local Zotero desktop library.

Research & AnalysisOct 8, 2026

Cli Anything Wiremock

hkuds

CLI harness for administering a WireMock HTTP mock server via its Admin REST API.

Software DevelopmentOct 8, 2026

Cli Anything Shotcut

hkuds

Command-line interface for creating and editing Shotcut video projects and rendering them without a GUI.

Design & CreativeOct 8, 2026

Cli Anything Videocaptioner

hkuds

CLI tool that transcribes video speech, optimizes and translates subtitles, and burns them into video.

Design & CreativeOct 8, 2026

Cli Anything Blender

hkuds

A stateful command-line interface for creating and editing Blender 3D scenes, with JSON output and preview rendering.

Design & CreativeOct 8, 2026

Cli Anything Safari

hkuds

Safari browser automation CLI on macOS via safari-mcp. Controls real Safari (native, keeps logins) by wrapping the safari-mcp MCP server. Every one of the 84 MCP tools is exposed 1:1 with schema-accurate arguments — guaranteed parity, no manual drift.

Awaiting classificationOct 8, 2026

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

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

Command	Description
`event <index>`	Choose an event option
`advance-dialogue`	Advance dialogue-only events
`rest <index>`	Choose a campfire action

Option	Default	Description
`--base-url`	`http://localhost:15526`	Bridge API URL
`--timeout`	`10.0`	HTTP timeout in seconds

Cli Anything Slay The Spire Ii

cli-anything-slay-the-spire-ii

Installation

1. Install the CLI

2. Build and install the bridge mod

3. Enable the mod and verify

Usage

Basic Commands

Command Groups

State Inspection

Main Menu

Combat

Map & Room Flow

Rewards

Events & Rest Sites

Shop

Card/Relic Selection Overlays

Raw Action

Decision States

Configuration

For AI Agents

Source and attribution

More from hkuds/cli-anything

Cli Anything Zotero

Cli Anything Wiremock

Cli Anything Shotcut

Cli Anything Videocaptioner

Cli Anything Blender

Cli Anything Safari

More in Other

Saju Fortune

Naming House

Lotto Results

Workout Program Designer

Ultrathink

Value