Go to file
Krzysztof kuhy Rudnicki a32ab66c5a
Some checks are pending
md-naming / markdown naming convention (push) Waiting to run
pre-commit / pre-commit (${{ matrix.group }}) (mypy, mypy, ) (push) Waiting to run
pre-commit / pre-commit (${{ matrix.group }}) (pylint, pylint, ) (push) Waiting to run
pre-commit / pre-commit (${{ matrix.group }}) (rest, , mypy,pylint,dependency-freshness) (push) Waiting to run
Tests / test (push) Waiting to run
Tests / web-coverage (push) Waiting to run
repo-contract / repo contract (push) Waiting to run
Label the install button Install
Install targets any game allowed today, so "Install assigned" was wrong.
Test reads the Astro pages, which vitest never renders.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01WzxdWZCxnNWLtpVwFLVk9w
2026-11-22 21:53:24 +01:00
.github/workflows Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
docs/explanations feat(enforcer): raise manual pick cap from 2 to 3 concurrent games 2026-07-23 18:05:29 +02:00
pacman-hooks Add a daily gaming-time budget with a binary-level cutoff 2026-08-04 20:00:08 +02:00
scripts Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
steam_backlog_enforcer Add map-installed Proton map view and apply job 2026-11-22 21:43:23 +01:00
steam_installer Add map-installed Proton map view and apply job 2026-11-22 21:43:23 +01:00
web Label the install button Install 2026-11-22 21:53:24 +01:00
.gitignore Add CI-mirror pre-push gate + requirements-sync check 2026-07-11 17:47:14 +02:00
.gitleaksignore Ignore fake test key fingerprints 2026-11-22 20:31:08 +01:00
.mcp.json Add MCP server exposing the enforcer to Claude Code 2026-07-10 21:05:17 +02:00
.pre-commit-config.yaml Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
AGENTS.md Split ci-mirror gate into <60 s steps 2026-11-11 16:29:08 +01:00
CLAUDE.md Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
DOCS-ctl-socket.md Verify store unblock/re-block; file failures 2026-11-22 17:07:29 +01:00
DOCS-icon-words.md Register every UI icon word in the registry 2026-11-16 10:50:45 +01:00
DOCS-steam-installer.md Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
DOCS-web-control-api.md Add repair-ghosts job with POST-time friction 2026-11-22 21:08:36 +01:00
DOCS-web-install.md Add map-installed Proton map view and apply job 2026-11-22 21:43:23 +01:00
install.sh Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
LICENSE chore: add MIT LICENSE 2026-10-11 18:12:51 +02:00
pyproject.toml Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
README.md Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
requirements.txt Merge steam-game-installer into the repo 2026-11-22 20:25:39 +01:00
run.sh web control UI: all 24 commands in React, ctl.sock daemon, jobs, library browser; earned_time 0.7.0 2026-10-10 16:07:42 +02:00
steam-backlog-enforcer-web.service Stop the web UI serving numbers the enforcer is not applying 2026-08-29 23:39:40 +02:00
steam-backlog-enforcer.desktop web control UI: all 24 commands in React, ctl.sock daemon, jobs, library browser; earned_time 0.7.0 2026-10-10 16:07:42 +02:00
steam-backlog-enforcer.service web control UI: all 24 commands in React, ctl.sock daemon, jobs, library browser; earned_time 0.7.0 2026-10-10 16:07:42 +02:00

Steam Backlog Enforcer

This repo is also an alternative Steam frontend: it installs games faster than the Steam client (steam_installer, see DOCS-steam-installer.md).

Forces you to play one Steam game at a time: earn at least one new achievement in the assigned game before moving on to the next.

Requiring 100% completion kept you locked onto one game for weeks, which proved ineffective. A game released after one new achievement stays in the backlog (it is not counted as finished) and comes round again later.

Features

  • Achievement tracking: Picks the least-recently-assigned game next, then the shortest HLTB completionist time; a released game sits out a 7-day cooldown
  • Store blocking: Blocks store.steampowered.com via /etc/hosts
  • Game uninstalling: Removes all installed games except the assigned one
  • Process enforcement: Kills unauthorized game processes
  • Tampering detection: Detects achievement unlocks on non-assigned games
  • HLTB integration: Estimates completion time with persistent cache

Setup

python -m python_pkg.steam_backlog_enforcer.main setup

Commands

Command Description
scan Scan library, fetch HLTB data, assign game
check Check assigned game for a new achievement
status Show current assignment and blocking
list List incomplete games from snapshot
skip Skip the currently assigned game
enforce Run enforcer (block, uninstall, kill)
unblock [minutes] Unblock the store for a window (default 15, max 30); the daemon keeps it open and re-blocks after
buy-dlc Same 15-minute store window, to buy a game or DLC
reset Reset all state
total-block-research --until T Root. One window per total block, up to its end, extendable once: Steam and the store open, only Librarian may be played; the daemon re-applies the full block at T and keeps ~/.local/share/Steam
installed List currently installed Steam games
uninstall Interactively uninstall non-assigned games
setup First-time configuration

Enforce mode

sudo python -m python_pkg.steam_backlog_enforcer.main enforce

This will:

  1. Block Steam store in /etc/hosts
  2. Uninstall all games except the assigned one
  3. Continuously kill any unauthorized game processes

Game Uninstall

Directly removes appmanifest files and game directories from ~/.local/share/Steam/steamapps/. Preserves Proton versions and Steam Linux Runtime.

python -m python_pkg.steam_backlog_enforcer.main uninstall

MCP server (Claude Code integration)

The enforcer exposes an MCP server (steam_backlog_enforcer._mcp) so Claude Code and its subagents can query the backlog and drive it through typed tools.

  • Read tools: get_dataset, get_status, get_stats, list_backlog.
  • Gated write tools: pick_manual, block_gaming — each defaults to a dry-run preview; pass confirm=true to actually apply. These write tools must never be added to a permission allowlist (a subagent could otherwise bypass the human confirmation).

The mcp SDK is an optional dependency (pip install -e '.[mcp]'), kept out of the CLI/systemd system-python path. One-time setup of the dedicated venv that Claude Code spawns:

./scripts/setup_mcp.sh

Registration lives in the checked-in .mcp.json (project scope). Restart Claude Code in this repo and approve the project MCP-server prompt for it to load. Verify with claude mcp list.

Steam game installer

steam_installer (merged in from steam-game-installer) downloads an owned game with depotdownloader and makes Steam accept it as installed. The daemon runs it as python3 -m steam_installer.cli; by hand use steam_installer/run.sh <appid|url|name>. Dependencies: steam_installer/install_deps.sh (run by install.sh). Details in DOCS-steam-installer.md.