A CLI that finds all those free games from all those game stores.
And, if you want, posts them to a Chatto channel. MCP server included.

2 提交历史

1 代码分支

0 版本发布

Paul Klumpp 6fe3cd7732 AGENTS/README: add free-games-notifier as second reference (steam sources, upcoming offers, state-diff pattern)		3 天之前
cmd	3a538ed86f Initial CLI: list + watch for Epic free games (cobra, epic storefront API)	3 天之前
internal	3a538ed86f Initial CLI: list + watch for Epic free games (cobra, epic storefront API)	3 天之前
.gitignore	3a538ed86f Initial CLI: list + watch for Epic free games (cobra, epic storefront API)	3 天之前
AGENTS.md	6fe3cd7732 AGENTS/README: add free-games-notifier as second reference (steam sources, upcoming offers, state-diff pattern)	3 天之前
LICENSE	3a538ed86f Initial CLI: list + watch for Epic free games (cobra, epic storefront API)	3 天之前
README.md	6fe3cd7732 AGENTS/README: add free-games-notifier as second reference (steam sources, upcoming offers, state-diff pattern)	3 天之前
go.mod	3a538ed86f Initial CLI: list + watch for Epic free games (cobra, epic storefront API)	3 天之前
go.sum	3a538ed86f Initial CLI: list + watch for Epic free games (cobra, epic storefront API)	3 天之前

cheapo

A CLI that finds all those free games from all those game stores. And, if you want, posts them to a Chatto channel.

Free games CLI in Go — lists current free game offers (currently: Epic Games Store) and can use watch to wait for new free games.

Inspired by / reference: free-games-claimer (a fork of vogler/free-games-claimer). Unlike the reference project, we need no browser and no login: we read the public storefront backend endpoint directly (freeGamesPromotions, see AGENTS.md). Claiming the games is not part of this tool — it only detects and reports them.

Install / build

go build -o bin/cheapo ./cmd/cheapo

Prerequisites: Go ≥ 1.27. For linting: gopls (go install golang.org/x/tools/gopls@latest), formatting with gofmt (details: AGENTS.md).

Usage

# Games free right now (Germany, German)
cheapo list

# As JSON (e.g. for further processing / bot)
cheapo list --json

# Other region / locale
cheapo list --country AT --locale en-US

# Wait for new free games (polling every 15 min, baseline = current state)
cheapo watch

# Different interval, single check
cheapo watch --interval 5m
cheapo watch --once

Example output:

🎮 Monument Valley
   By: Netflix, Inc.
   Instead of: 6.99 €
   Free until: 02.11.2026 17:00 (CET)
   https://store.epicgames.com/en-US/p/monument-valley-1d99d3

cheapo watch is suitable as a long runner for a systemd service or cron/timer; every newly detected game is reported on stderr as soon as a poll finds it.

Roadmap / MCP (later)

Planned next step: expose the tools (list, watch) as an MCP server, so they can be used e.g. by Hermes or other MCP clients. Planned:

Transport: stdio (classic) — one binary cheapo mcp
Tools: list_free_games (immediately) and check_now (single poll, for cron/eventing)
The watch logic (internal/watch) stays reusable; the MCP server only wraps it.
Not implemented yet — deliberately a second step after the CLI stabilizes.

More platforms (idea, from free-games-notifier)

Epic "upcoming": The Epic endpoint also returns upcomingPromotionalOffers — a preview of future free promotions (see AGENTS.md). Could be added as cheapo list --upcoming.
Steam: Free-to-keep via HTML scrape of store.steampowered.com/search/?maxprice=free&specials=1, free weekend via store.steampowered.com/api/featuredcategories/ (details: AGENTS.md).

Architecture

cmd/cheapo/       Cobra CLI (list, watch)
internal/epic/    Client for the Epic storefront endpoint (freeGamesPromotions)
internal/watch/   Polling/eventing: reports only newly added games

Reference: how the original project works

The reference project (vogler/free-games-claimer) automates a real browser with Playwright: login (session cookies, 2FA, captcha handling), detecting the "Free Now" tiles on the store page and clicking through the purchase process. The free games info comes from the same backend JSON that we query directly — details and sources in AGENTS.md.

README.md