Steam Games CLI

# 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