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.

1 Commits

1 Branches

0 Releases

Paul Klumpp 3a538ed86f Initial CLI: list + watch for Epic free games (cobra, epic storefront API)		vor 3 Tagen
cmd	3a538ed86f Initial CLI: list + watch for Epic free games (cobra, epic storefront API)	vor 3 Tagen
internal	3a538ed86f Initial CLI: list + watch for Epic free games (cobra, epic storefront API)	vor 3 Tagen
.gitignore	3a538ed86f Initial CLI: list + watch for Epic free games (cobra, epic storefront API)	vor 3 Tagen
AGENTS.md	3a538ed86f Initial CLI: list + watch for Epic free games (cobra, epic storefront API)	vor 3 Tagen
LICENSE	3a538ed86f Initial CLI: list + watch for Epic free games (cobra, epic storefront API)	vor 3 Tagen
README.md	3a538ed86f Initial CLI: list + watch for Epic free games (cobra, epic storefront API)	vor 3 Tagen
go.mod	3a538ed86f Initial CLI: list + watch for Epic free games (cobra, epic storefront API)	vor 3 Tagen
go.sum	3a538ed86f Initial CLI: list + watch for Epic free games (cobra, epic storefront API)	vor 3 Tagen

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.

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