steam

# Steam Games CLI CLI for browsing and discovering games in your Steam library. Filter by playtime, reviews, Deck compatibility, genres, and tags. ## Installation ```bash npm install -g steam-games-cli ``` ## Setup 1. Get a Steam Web API key from https://steamcommunity.com/dev/apikey 2. Configure the CLI: ```bash steam config set-key YOUR_API_KEY steam config set-user YOUR_STEAM_ID ``` ## Commands ### Profile ```bash steam whoami # Profile info and library stats steam whoami --json ``` ### Library ```bash steam library # List all games steam library --limit 10 # Limit results steam library --json # JSON output for scripting ``` ### Tags & Genres (Instant) ```bash steam tags # List all 440+ Steam tags steam tags --json steam genres # List all genres steam genres --json ``` ## Filtering Options ### Playtime ```bash steam library --unplayed # Never played steam library --min-hours 10 # At least 10 hours steam library --max-hours 5 # Less than 5 hours steam library --deck # Played on Steam Deck ``` ### Reviews (1-9 scale) ```bash steam library --reviews very-positive # Exact category steam library --min-reviews 7 # Score 7+ (Positive and above) steam library --show-reviews # Show review column ``` **Categories:** overwhelmingly-positive (9), very-positive (8), positive (7), mostly-positive (6), mixed (5), mostly-negative (4), negative (3), very-negative (2), overwhelmingly-negative (1) ### Steam Deck Compatibility ```bash steam library --deck-compat verified # Verified only steam library --deck-compat playable # Playable only steam library --deck-compat ok # Verified OR Playable steam library --show-compat # Show Deck column ``` ### Tags & Genres ```bash steam library --tag "Roguelike" # Filter by tag steam library --genre "Strategy" # Filter by genre steam library --show-tags # Show tags column ``` ### Sorting ```bash steam library --sort name # Alphabetical (default) steam library --sort playtime # Most played first steam library --sort deck # Most Deck playtime first steam library --sort reviews # Best reviewed first steam library --sort compat # Best Deck compat first ``` ## AI Agent Workflow The CLI is optimized for AI agents with stream fusion and early termination. ### Step 1: Discover available tags/genres (instant) ```bash steam tags --json steam genres --json ``` ### Step 2: Filter library with combined criteria ```bash # Unplayed Deck Verified roguelikes with good reviews steam library --unplayed --deck-compat verified --tag "Roguelike" --min-reviews 7 --limit 10 --json # Well-reviewed strategy games under 5 hours steam library --max-hours 5 --genre "Strategy" --min-reviews 8 --limit 5 --json # Trading games playable on Deck steam library --tag "Trading" --deck-compat ok --limit 10 --json ``` ### Performance Notes - Local filters (playtime, unplayed) apply first - instant - Remote filters (reviews, deck compat, tags) fetch in parallel per game - Early termination: stops when limit is reached - Use local filters first to minimize API calls ## Usage Examples **User: "What should I play on my Steam Deck?"** ```bash steam library --deck-compat verified --min-reviews 7 --sort playtime --limit 10 ``` **User: "What roguelikes do I have?"** ```bash steam library --tag "Roguelike" --show-tags --limit 20 ``` **User: "What unplayed games are highly rated?"** ```bash steam library --unplayed --min-reviews 8 --sort reviews --limit 10 --show-reviews ``` **User: "How many games do I have?"** ```bash steam whoami ``` **User: "What strategy games work on Deck?"** ```bash steam library --genre "Strategy" --deck-compat ok --show-compat --limit 15 ``` **User: "What tags are available?"** ```bash steam tags --json ``` ## Output Formats - Default: Colored table - `--plain`: Plain text list - `--json`: JSON for scripting/AI agents