---

name: steam description: Browse, filter, and discover games in a Steam library. Filter by playtime, reviews, Steam Deck compatibility, genres, and tags. Use when user asks about their Steam games, what to play, game recommendations, or Steam Deck compatible games. homepage: https://github.com/mjrussell/steam-cli metadata: clawdbot: emoji: "🎮" requires: bins: ["steam"] env: ["STEAM_API_KEY"]

Steam Games CLI

CLI for browsing and discovering games in your Steam library. Filter by playtime, reviews, Deck compatibility, genres, and tags.

Installation

Copynpm install -g steam-games-cli

Setup

1. Get a Steam Web API key from https://steamcommunity.com/dev/apikey
2. Configure the CLI:

Copysteam config set-key YOUR_API_KEY
steam config set-user YOUR_STEAM_ID

Commands

Profile

Copysteam whoami               # Profile info and library stats
steam whoami --json

Library

Copysteam library              # List all games
steam library --limit 10   # Limit results
steam library --json       # JSON output for scripting

Tags & Genres (Instant)

Copysteam tags                 # List all 440+ Steam tags
steam tags --json
steam genres               # List all genres
steam genres --json

Filtering Options

Playtime

Copysteam 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)

Copysteam 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

Copysteam 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

Copysteam library --tag "Roguelike"             # Filter by tag
steam library --genre "Strategy"            # Filter by genre
steam library --show-tags                   # Show tags column

Sorting

Copysteam 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)

Copysteam tags --json
steam genres --json

Step 2: Filter library with combined criteria

Copy# 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?"

Copysteam library --deck-compat verified --min-reviews 7 --sort playtime --limit 10

User: "What roguelikes do I have?"

Copysteam library --tag "Roguelike" --show-tags --limit 20

User: "What unplayed games are highly rated?"

Copysteam library --unplayed --min-reviews 8 --sort reviews --limit 10 --show-reviews

User: "How many games do I have?"

Copysteam whoami

User: "What strategy games work on Deck?"

Copysteam library --genre "Strategy" --deck-compat ok --show-compat --limit 15

User: "What tags are available?"

Copysteam tags --json

Output Formats

• Default: Colored table
• --plain: Plain text list
• --json: JSON for scripting/AI agents