kbarbel640-del Steam Games CLI
CLI for browsing and discovering games in your Steam library. Filter by playtime, reviews, Deck compatibility, genres, and tags.
Installation
npm install -g steam-games-cli
Setup
- Get a Steam Web API key from https://steamcommunity.com/dev/apikey
- Configure the CLI:
steam config set-key YOUR_API_KEY
steam config set-user YOUR_STEAM_ID
Commands
Profile
steam whoami # Profile info and library stats
steam whoami --json
Library
steam library # List all games
steam library --limit 10 # Limit results
steam library --json # JSON output for scripting
Tags & Genres (Instant)
steam tags # List all 440+ Steam tags
steam tags --json
steam genres # List all genres
steam genres --json
Filtering Options
Playtime
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)
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
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
steam library --tag "Roguelike" # Filter by tag
steam library --genre "Strategy" # Filter by genre
steam library --show-tags # Show tags column
Sorting
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)
steam tags --json
steam genres --json
Step 2: Filter library with combined criteria
# 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?"
steam library --deck-compat verified --min-reviews 7 --sort playtime --limit 10
User: "What roguelikes do I have?"
steam library --tag "Roguelike" --show-tags --limit 20
User: "What unplayed games are highly rated?"
steam library --unplayed --min-reviews 8 --sort reviews --limit 10 --show-reviews
User: "How many games do I have?"
steam whoami
User: "What strategy games work on Deck?"
steam library --genre "Strategy" --deck-compat ok --show-compat --limit 15
User: "What tags are available?"
steam tags --json
Output Formats
- Default: Colored table
--plain: Plain text list--json: JSON for scripting/AI agents