MCPInstall

cli-anything-slay-the-spire-ii

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.

Installs
475
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-slay-the-spire-ii
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads cli-anything-slay-the-spire-ii automatically when relevant.

  3. 03

    Review the result

    The agent follows the SKILL.md steps, scripts and references bundled with the skill.

SKILL.md

The instructions your agent reads when the skill is triggered.

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-Anything

1. 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.sh

If 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.sh

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:

cli-anything-sts2 state

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

# 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 --help

Command Groups

State Inspection

CommandDescription
stateNormalized state with decision field
raw-stateRaw bridge JSON

Main Menu

CommandDescription
continue-gameContinue a saved run
start-game --character IRONCLAD --ascension 0Start a new run
abandon-gameAbandon the current save
return-to-main-menuReturn to menu from any screen

Characters: IRONCLAD, SILENT, DEFECT, NECROBINDER, REGENT

Combat

CommandDescription
play-card <index> [--target <enemy_id>]Play a card from hand
use-potion <slot> [--target <enemy_id>]Use a potion
end-turnEnd the current turn

Map & Room Flow

CommandDescription
choose-map <index>Select a map node
proceedLeave the current room

Rewards

CommandDescription
claim-reward <index>Claim a combat reward
pick-card-reward <index>Pick a card reward
skip-card-rewardSkip the card reward
claim-treasure-relic <index>Claim a treasure relic
select-relic <index>Select a relic
skip-relic-selectionSkip relic selection

Events & Rest Sites

CommandDescription
event <index>Choose an event option
advance-dialogueAdvance dialogue-only events
rest <index>Choose a campfire action

Shop

CommandDescription
shop-buy <index>Buy from the shop

Card/Relic Selection Overlays

CommandDescription
select-card <index>Select a card in overlay
confirm-selectionConfirm the current selection
cancel-selectionCancel the current selection
combat-select-card <index>Select a card during combat overlay
combat-confirm-selectionConfirm combat card selection

Raw Action

CommandDescription
action <name> --kv key=valueSend 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:

DecisionMeaningTypical Next Commands
menuMain menucontinue-game, start-game
combat_playIn combat, your turnplay-card, use-potion, end-turn
hand_selectCard selection overlaycombat-select-card, combat-confirm-selection
map_selectMap node selectionchoose-map
game_overRun endedreturn-to-main-menu
combat_rewardsPost-combat rewardsclaim-reward, proceed
card_rewardCard reward pickpick-card-reward, skip-card-reward
event_choiceEvent screenevent, advance-dialogue
rest_siteCampfirerest
shopShop screenshop-buy, proceed
card_selectCard selection screenselect-card, confirm-selection
relic_selectRelic selectionselect-relic, skip-relic-selection
treasureTreasure roomclaim-treasure-relic, proceed

Configuration

OptionDefaultDescription
--base-urlhttp://localhost:15526Bridge API URL
--timeout10.0HTTP 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

FAQ

What does the cli-anything-slay-the-spire-ii skill do?

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.

How do I install cli-anything-slay-the-spire-ii?

Run npx skills add https://github.com/hkuds/cli-anything --skill cli-anything-slay-the-spire-ii in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/cli-anything-slay-the-spire-ii/ (personal) or .claude/skills/cli-anything-slay-the-spire-ii/ (project).

Which AI agents can use cli-anything-slay-the-spire-ii?

Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.

Is cli-anything-slay-the-spire-ii safe to install?

No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.

Who maintains cli-anything-slay-the-spire-ii?

It is published by hkuds in hkuds/cli-anything. It has 475 recorded installs.

More from hkuds/cli-anything

View all →

cli-hub-meta-skill

hkuds/cli-anything

Discover agent-native CLIs for professional software. Access the live catalog to find tools for creative workflows, productivity, AI, and more.

Media & Creative5.4K installs

cli-anything

hkuds/cli-anything

Use when the user wants Codex to build, refine, test, validate, or list CLI-Anything harnesses for GUI applications or source repositories. Adapts the full CLI-Anything methodology to Codex without changing the generated Python harness format.

Testing & QA2.1K installs

cli-anything-blender

hkuds/cli-anything

Command-line interface for Blender - A stateful command-line interface for 3D scene editing, following the same patterns as the GIMP CLI ...

Media & Creative959 installs

cli-anything-obsidian

hkuds/cli-anything

Command-line interface for Obsidian — Knowledge management and note-taking via Obsidian Local REST API. Designed for AI agents and power users who need to manage notes, search the vault, and execute commands without the GUI.

cli-anything-notebooklm

hkuds/cli-anything

Experimental NotebookLM harness for listing notebooks, managing sources, asking questions, generating artifacts, and downloading outputs through an installed notebooklm CLI.

815 installs

cli-anything-libreoffice

hkuds/cli-anything

Command-line interface for Libreoffice - A stateful command-line interface for document editing, producing real ODF files (ZIP archives with ...

678 installs

Popular media & creative skills

View category →

hyperframes

heygen-com/hyperframes

Read first to make, edit, animate or render any video with HyperFrames (HTML rendered to video), including launch films, explainers, music videos, charts, maps, vertical clips, title cards, captions and overlays. Holds the render contract, the work loop and what each kind of video needs.

Media & Creative1.2M installs

media-use

heygen-com/hyperframes

Get or make any media for a HyperFrames video - music, sound effects, images, icons, logos, voiceover, avatar and generated video, transcripts, cutouts, colour grades and looks - with HeyGen or free local tools, and mix placed audio. Also for footage that looks dark, flat or dull, or should be stylized or hidden.

Media & Creative1.1M installs

hyperframes-registry

heygen-com/hyperframes

About 450 ready-made HyperFrames blocks and components installed as editable source - transitions, overlays, titles, kinetic type, captions, charts, map overlays, 3D, camera moves. Use it before hand-building any named visual (CRT scanlines, glitch, film grain, a chart); also for hyperframes add and catalog.

Media & Creative1M installs

hyperframes-creative

heygen-com/hyperframes

Non-animation creative direction for HyperFrames videos. Use for design spec (frame.md / design.md) handling, palettes, typography, narration, beat planning, audio-reactive visuals, composition patterns, and brand / style decisions. For atomic motion patterns and scene blueprints, use hyperframes-animation.

Media & Creative916.5K installs

ai-video-generation

101-skills/superpowers

Generate AI videos with Google Veo, Seedance 2.0, HappyHorse, Wan, Grok and 40+ models via inference.sh CLI. Models: Veo 3.1, Veo 3, Seedance 2.0, HappyHorse 1.0, Wan 2.5, Grok Imagine Video, OmniHuman, Fabric, HunyuanVideo. Capabilities: text-to-video, image-to-video, reference-to-video, video editing, lipsync, avatar animation, video upscaling, foley sound. Use for: social media videos, marketing content, explainer videos, product demos, AI avatars. Triggers: video generation, ai video, text to video, image to video, veo, animate image, video from image, ai animation, video generator, generate video, t2v, i2v, ai video maker, create video with ai, runway alternative, pika alternative, sora alternative, kling alternative, seedance, happyhorse

Media & Creative881.5K installs

ai-image-generation

101-skills/superpowers

Generate AI images with GPT-Image-2, FLUX, Gemini, Grok, Seedream, Reve and 50+ models via inference.sh CLI. Models: GPT-Image-2, FLUX Dev LoRA, FLUX.2 Klein LoRA, Gemini 3 Pro Image, Grok Imagine, Seedream 4.5, Reve, ImagineArt. Capabilities: text-to-image, image-to-image, inpainting, LoRA, image editing, upscaling, text rendering. Use for: AI art, product mockups, concept art, social media graphics, marketing visuals, illustrations. Triggers: flux, image generation, ai image, text to image, stable diffusion, generate image, ai art, midjourney alternative, dall-e alternative, text2img, t2i, image generator, ai picture, create image with ai, generative ai, ai illustration, grok image, gemini image, gpt image, openai image, chatgpt image

Media & Creative880.3K installs