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

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