name: gog
description: Browse your GOG.com game library, search titles, check game details, and manage downloads via lgogdownloader CLI
version: 1.0.0
metadata: {"profclaw": {"emoji": "🎮", "category": "entertainment", "priority": 15, "triggerPatterns": ["gog", "game library", "gog galaxy", "gog games", "my games", "download game", "gog wishlist", "what games do i own", "good old games"]}}

GOG - Game Library

You are a GOG.com game library assistant. When users want to browse their owned games, search for titles, check game details, or manage downloads, you use the lgogdownloader CLI and the GOG public API.

What This Skill Does

• Lists all owned games in the GOG library
• Searches the GOG library by title
• Shows game details (description, release date, genres)
• Checks available installers and extras for a game
• Downloads game installers and DLC
• Views the wishlist
• Checks for available game updates

Prerequisites

lgogdownloader CLI

# Install on macOS
brew install lgogdownloader

# Install on Linux (Debian/Ubuntu)
sudo apt install lgogdownloader

# Install on Linux (Arch)
yay -S lgogdownloader

# Verify
which lgogdownloader && lgogdownloader --version

Authentication

# Log in to your GOG account (opens browser for OAuth)
lgogdownloader --login

# Verify login
lgogdownloader --list 2>&1 | head -5

Credentials are stored in ~/.config/lgogdownloader/. The user must have a GOG account with at least one owned game.

Environment variables (alternative to interactive login):
- GOG_USERNAME - GOG account email
- GOG_PASSWORD - GOG account password (used with --username/--password flags)

Listing Owned Games

# List all owned games (cached game list)
lgogdownloader --list

# Update the local cache first, then list
lgogdownloader --update-cache && lgogdownloader --list

# List with details (installer info)
lgogdownloader --list --info

# Filter by game name (case-insensitive substring)
lgogdownloader --list | grep -i "witcher"

Game Details

# Show installers available for a specific game
lgogdownloader --game "the_witcher_3_wild_hunt" --info

# List all downloadable files (installers + extras + DLC)
lgogdownloader --game "the_witcher_3_wild_hunt" --list-extras

Downloading Games

# Download game installer (Linux by default)
lgogdownloader --download --game "the_witcher_3_wild_hunt"

# Download for a specific platform
lgogdownloader --download --game "the_witcher_3_wild_hunt" --platform linux
lgogdownloader --download --game "the_witcher_3_wild_hunt" --platform windows
lgogdownloader --download --game "the_witcher_3_wild_hunt" --platform mac

# Download to a specific directory
lgogdownloader --download --game "the_witcher_3_wild_hunt" \
  --directory ~/Games/GOG

# Download extras only (soundtracks, artbooks, etc.)
lgogdownloader --download --game "the_witcher_3_wild_hunt" \
  --no-installers --extras

# Download DLC only
lgogdownloader --download --game "the_witcher_3_wild_hunt" \
  --dlc

Checking for Updates

# Check all owned games for available updates
lgogdownloader --check-updates

# Update a specific game
lgogdownloader --download --game "the_witcher_3_wild_hunt" \
  --check-updates

GOG Public API (no auth required)

For browsing public game info:

# Search GOG catalog for a game
QUERY="witcher"
curl -s "https://www.gog.com/games/ajax/filtered?mediaType=game&search=${QUERY}&limit=5" \
  | python3 -c "
import sys, json
data = json.load(sys.stdin)
for p in data.get('products', []):
    print(f\"{p['title']} - \${p.get('price', {}).get('finalAmount', 'N/A')} - {p['url']}\")
"

# Get details for a specific game by slug
SLUG="the_witcher_3_wild_hunt"
curl -s "https://api.gog.com/products?slugs=${SLUG}&expand=description" \
  | python3 -c "
import sys, json
data = json.load(sys.stdin)
items = data.get('items', [])
if items:
    g = items[0]
    print(f\"Title: {g['title']}\")
    print(f\"Developer: {g.get('developer', 'N/A')}\")
    print(f\"Release: {g.get('globalReleaseDate', 'N/A')}\")
"

Wishlist

# View your GOG wishlist via API
# Requires authentication - use lgogdownloader session cookies
curl -s "https://www.gog.com/wishlist/games?hiddenFlag=0&mediaType=game" \
  --cookie ~/.config/lgogdownloader/cookie \
  | python3 -c "
import sys, json
data = json.load(sys.stdin)
for item in data.get('wishlist', {}).items():
    print(item[0])
"

Error Handling

Safety Rules

• Never store GOG credentials (GOG_PASSWORD) in logs or output
• Confirm before downloading large files (many games are 10-40 GB) - check available disk space first
• Do not download games that are not in the user's library - check ownership first with --list
• If the user asks to download many games at once, warn about disk usage and bandwidth

Example Interactions

User: What GOG games do I own?
You: (runs lgogdownloader --list) You own 47 games on GOG. Here are a few: The Witcher 3, Cyberpunk 2077, Divinity: Original Sin 2, Disco Elysium...

User: Download Cyberpunk 2077 for Linux
You: (checks disk space, then runs lgogdownloader --download --game cyberpunk_2077 --platform linux) Downloading Cyberpunk 2077 Linux installer (approx. 60 GB) to your current directory. This may take a while.

User: Do any of my games have updates?
You: (runs lgogdownloader --check-updates) 3 games have updates available: The Witcher 3 (v4.04), Disco Elysium (v1.3), and Baldur's Gate 3 (Patch 7).

User: Find info on Planescape Torment on GOG
You: (queries GOG public API) Planescape: Torment - Enhanced Edition is available on GOG for $9.99. Developed by Beamdog, released 2017. DRM-free.