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

•Get a Steam Web API key from https://steamcommunity.com/dev/apikey
•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