Slay the Spire AI Assistant

AI-powered strategic advisor that reads your game's save file for accurate state tracking and provides deck building guidance with map intelligence.

Version 3.2.1 - Fixed oracle map output to use JSON for AI parsing

Features

• Save File Integration - Reads game files for perfect accuracy (HP, deck, relics)
• Map Intelligence - Track path progress, estimate remaining nodes
• Optional Full Maps - Install sts_map_oracle for complete map visualization
• Screenshot Analysis - Parses decision screens (card rewards, shop, events)
• Archetype Detection - Identifies your deck strategy with confidence scoring
• Strategic Advice - Card recommendations, shop priorities, pathing guidance

Commands

Command	Purpose
/slay-the-spire:play	Show run status + map progress
/slay-the-spire:setup	Install oracle, configure settings
/slay-the-spire:reset	Clear state for new run

What This Tool Does

Strategic Guidance For:

• Card reward decisions (which card fits your build)
• Shop purchases and removals
• Event choices
• Elite timing and rest site planning
• Map pathing with remaining node estimates
• Upgrade priorities

NOT For:

• Combat tactics or turn-by-turn play
• Which cards to play in battle

Requirements

• Claude Code
• Slay the Spire (Steam version)
• Optional: sts_map_oracle for full map features

Installation

Via Claude Code Marketplace (Recommended)

/plugin marketplace add ben-w-smith/spire
/plugin install slay-the-spire@slay-the-spire

Manual Installation

cd ~/.claude/plugins
git clone https://github.com/ben-w-smith/spire.git

The commands will be immediately available.

Quick Start

# First-time setup (detects save location, optionally installs oracle)
/slay-the-spire:setup

# Check current run status with map progress
/slay-the-spire:play

# Provide a screenshot for specific advice
/slay-the-spire:play
[paste screenshot of card rewards, shop, etc.]

# Reset for a new run
/slay-the-spire:reset

Map Intelligence

Tier 1: Enhanced Heuristics (Default)

Works automatically without any setup:

--- Map Progress ---
Path: M → ? → E → R → M → ? → M
Visited: 3 monsters, 1 elite, 1 rest, 2 events

Remaining (estimated):
• Floors: 8 until boss
• Elites: 1-2 available
• Rest Sites: 1-2 remaining
• Shops: 0-1 remaining

💡 Recommendation: With 45/80 HP (56%), consider rest site
   before next elite.

Tier 2: Full Map (With Oracle)

Install sts_map_oracle for complete map data:

/slay-the-spire:setup install

This downloads and installs the map oracle binary (~3MB). Then you get structured JSON map data:

## Map Data (Oracle JSON)

```json
{
  "nodes": [
    {"x": 0, "y": 0, "class": "MonsterRoom"},
    {"x": 1, "y": 0, "class": "MonsterRoom"},
    {"x": 0, "y": 1, "class": "ShopRoom"},
    {"x": 1, "y": 1, "class": "MonsterRoom"},
    ...
  ],
  "edges": [
    {"src_x": 0, "src_y": 0, "dst_x": 0, "dst_y": 1},
    {"src_x": 0, "src_y": 0, "dst_x": 1, "dst_y": 1},
    ...
  ]
}

Note: Use this JSON for map analysis - it contains complete node positions, edges, and room types.

💡 Recommendation: Go RIGHT at next branch. Path leads to rest site at floor 10.

## Settings

Location: `~/.claude/spire/settings.md` (human-readable markdown format)

```markdown
# Slay the Spire Settings

## Paths
save_directory: /path/to/saves/
oracle_path: /path/to/sts_map_oracle

## Preferences
oracle_installed: true

Edit directly or re-run setup to reconfigure.

How It Works

Primary: Save File Reading

The tool reads your Slay the Spire save files for accurate state:

Platform	Save Location
macOS	~/Library/Application Support/Steam/steamapps/common/SlayTheSpire/.../saves/
Windows	%USERPROFILE%\AppData\LocalLow\Mega Crit\Slay the Spire\
Linux	~/.local/share/Steam/steamapps/common/SlayTheSpire/saves/

Secondary: Screenshot Analysis

For decision screens that aren't in the save file:

• Card reward options
• Shop inventory and prices
• Event choices
• Rest site options

Optional: sts_map_oracle

For full map reconstruction from game seed:

• Repository: https://github.com/Ru5ty0ne/sts_map_oracle
• Installed via /slay-the-spire:setup install
• Or manually place binary at ~/.claude/spire/bin/sts_map_oracle

Troubleshooting

"Save file not found"

Ensure Slay the Spire (Steam version) is installed. The tool auto-detects save locations.

"No active run"

Start a run in-game, get past character selection, then run /slay-the-spire again.

Oracle installation failed

Try manual installation:

1. Download from https://github.com/Ru5ty0ne/sts_map_oracle/releases
2. Place at ~/.claude/spire/bin/sts_map_oracle
3. Make executable: chmod +x ~/.claude/spire/bin/sts_map_oracle

Platform Support

Platform	Status	Notes
macOS (Steam)	✅ Tested	Full support
Windows (Steam)	✅ Documented	Should work
Linux (Steam)	✅ Documented	Should work
GOG/Epic	⚠️ Untested	Custom save path needed

Version History

• 3.2.1 (2026-01-26): Fixed oracle map output - JSON shown directly for AI parsing
• 3.2.0 (2026-01-26): Stable single-script architecture, AI documentation (AGENTS.md, docs/ARCHITECTURE.md)
• 3.0.0 (2026-01-26): Single script consolidation, markdown config templates
• 2.1.0 (2026-01-26): Map intelligence, multi-command structure, settings
• 2.0.0 (2026-01-26): Save file integration, simplified architecture
• 1.0.0 (2026-01-25): Initial release

See CHANGELOG.md for detailed release notes.

Links

• GitHub: https://github.com/ben-w-smith/spire
• sts_map_oracle: https://github.com/Ru5ty0ne/sts_map_oracle
• Claude Code: https://code.claude.com

License

MIT License - see LICENSE file.

Documentation

• AGENTS.md - Guide for AI assistants (Claude, Cursor, Copilot, etc.)
• docs/ARCHITECTURE.md - Technical specifications
• CHANGELOG.md - Complete version history

---

Version: 3.2.1 Last Updated: 2026-01-26 Author: Ben Smith