A cross-agent game configuration optimisation assistant for GitHub Copilot (VS Code), Google Antigravity, and Kiro. ReFrame detects your system hardware, locates game configuration files, analyses registry settings, and recommends or applies hardware-appropriate performance and eye-comfort improvements — with automatic backup, rollback, and named profile switching.
- System detection — reads CPU, GPU, RAM, storage type, and OS to build a hardware profile
- Config file analysis — finds and parses INI, CFG, XML, JSON, and other config formats across common game installation paths
- Registry analysis — checks Windows multimedia, scheduler, and GPU settings that affect gaming performance
- Hardware-appropriate recommendations — tailors suggestions to your hardware tier (high-end / mid-range / low-end)
- GPU vendor guidance — recommends DLSS (NVIDIA), FSR (AMD), or XeSS (Intel) where applicable
- Safe application — every change is previewed, confirmed, and backed up before writing
- Rollback — restore any previous config or registry state from the backup archive
- Named profile switching — save, list, diff, and switch between configurations for multi-monitor setups, remote play (Steam Link), or competitive presets
Future: Direct integration with AMD Adrenalin, NVIDIA Control Panel, and Intel Arc Control settings is planned but not yet available.
This gives you the full knowledge base (game-specific profiles, per-engine defaults) and keeps it up to date via git pull.
git clone https://github.com/CTOUT/ReFrame.git
cd ReFrame
.\install.ps1 -Target repo -Platform all- GitHub Copilot (VS Code): Open the
ReFramefolder in VS Code and select ReFrame (@ReFrame) in Copilot Chat. - Google Antigravity: Open the
ReFramefolder in Antigravity —AGENTS.mdand.agents/skills.jsonload the agent and all six skills automatically. - Kiro: Open the
ReFramefolder in Kiro —.kiro/steering/reframe.mdand.kiro/agents/reframe.json(@reframe) are active immediately.
To pin to a specific release or single platform:
.\install.ps1 -Target repo -Platform antigravity -Ref v1.2.0
Installs the agent globally for your preferred platform (-Platform copilot, antigravity, kiro, or all):
# PowerShell (Windows) — default: GitHub Copilot user-level install
irm https://raw.githubusercontent.com/CTOUT/ReFrame/main/install.ps1 | iex
# Or install globally for all supported AI agents (Copilot, Antigravity, Kiro) from a local script:
.\install.ps1 -Target user -Platform allNote: User-level installs do not include the
knowledge/files. Game-specific profiles (Tier 1) and per-engine JSON defaults (Tier 2) are unavailable — the agent falls back to generic best-practice rules (Tier 3) and web lookups when needed. For full knowledge base coverage, use the repo-level install above.
Download reframe-agent.zip from the latest release and extract to your workspace root, or copy the platform-specific user files to:
| Agent Platform | User-level path |
|---|---|
| GitHub Copilot (Windows) | %APPDATA%\Code\User\prompts\ |
| GitHub Copilot (macOS) | ~/Library/Application Support/Code/User/prompts/ |
| GitHub Copilot (Linux) | ~/.config/Code/User/prompts/ |
| Google Antigravity | ~/.gemini/config/skills/reframe/SKILL.md |
| Kiro | ~/.kiro/agents/reframe.json and ~/.kiro/agents/reframe.md |
Then restart or reload your IDE window.
The same knowledge base caveat applies — for game-specific profiles, use the repo-level install.
- GitHub Copilot (VS Code): Open Copilot Chat and select ReFrame from the agent picker, or type
@ReFrame. - Google Antigravity: Open the
ReFrameworkspace and chat directly (or activate thereframeskill in global installs). - Kiro: Open the
ReFrameworkspace and chat directly or invoke the@reframecustom agent.
scan system
Detects your hardware and shows a system profile.
optimise Elden Ring
Finds config files for the named game, analyses current settings, and recommends improvements for your hardware.
check registry
Assesses Windows gaming registry settings (multimedia scheduler, GPU scheduling, power plan, etc.) and shows what to change.
| Command | Description |
|---|---|
scan system |
Detect hardware profile |
optimise <game> |
Full optimisation workflow for the named game |
analyse config <path> |
Analyse a specific config file |
check registry |
Assess Windows gaming registry settings |
apply |
Apply the pending change preview (after confirmation) |
rollback <game> |
Restore a backup for the named game |
rollback last |
Restore the most recent backup |
list backups |
Show all ReFrame backups |
save profile <game> <name> |
Save active config as a named profile |
switch config <game> <name> |
Switch active config to a named profile |
list profiles [game] |
Show saved profiles and active state |
diff profiles <game> <a> <b> |
Compare settings between two profiles |
help |
Show command reference |
ReFrame never modifies files or registry keys silently. Every session that results in changes follows this flow:
- Scan — detect hardware and locate config files
- Analyse — parse configs and registry, flag suboptimal settings
- Preview — present a structured Change Preview showing old → new values and backup location
- Confirm — user must type yes to proceed
- Backup — original files are copied to
%LOCALAPPDATA%\ReFrame\Backups\<Game>_<timestamp>\ - Apply — changes are written
- Report — each change is confirmed in the output
Registry changes that require Administrator are shown as runnable PowerShell commands if the session does not have elevation.
- ReFrame never deletes files — it only modifies or backs up
- Registry changes use
Set-ItemPropertyonly — no key deletions - A system restart is required for some registry changes (HAGS, priority separation)
- Config file backups are stored locally in
%LOCALAPPDATA%\ReFrame\Backups\
See docs/TROUBLESHOOTING.md for help with common issues.
ReFrame/
├── .agents/
│ └── skills.json ← Google Antigravity zero-copy skill manifest
├── .github/
│ ├── agents/
│ │ └── reframe.agent.md ← GitHub Copilot agent definition
│ ├── ISSUE_TEMPLATE/ ← GitHub Issue Forms & knowledge submission
│ ├── skills/
│ │ ├── accessibility-modifiers/← on-demand modifier guidance
│ │ ├── apply-changes/ ← backup/apply/rollback workflow
│ │ ├── config-profiles/ ← named profile & switcher workflow
│ │ ├── knowledge-capture/ ← unknown-game profile capture
│ │ ├── registry-analysis/ ← on-demand registry review
│ │ └── system-scan/ ← hardware detection skill
│ ├── workflows/
│ │ ├── release.yml ← GitHub Actions release workflow
│ │ └── spellcheck.yml ← Documentation spellcheck CI
│ └── CODEOWNERS
├── .kiro/
│ ├── agents/
│ │ └── reframe.json ← Kiro custom @reframe agent definition
│ └── steering/
│ └── reframe.md ← Kiro workspace steering rules
├── .vscode/
│ └── extensions.json
├── docs/
│ ├── GAMES.md ← Human-readable game config reference
│ ├── REGISTRY.md ← Windows registry keys reference
│ └── TROUBLESHOOTING.md ← Common problems and fixes
├── knowledge/
│ ├── game-engines/ ← Per-engine default profiles (Tier 2)
│ ├── games/ ← Per-game config profiles (Tier 1)
│ ├── templates/ ← Templates for contributors
│ └── INDEX.json ← Machine-readable profile index
├── .editorconfig
├── .gitattributes
├── .gitignore
├── .markdownlint.json
├── .prettierrc
├── AGENTS.md ← Universal agent rules (Antigravity, Kiro, Copilot)
├── CHANGELOG.md
├── CITATION.cff
├── CONTRIBUTING.md
├── cspell.json
├── install.ps1
├── LICENSE
├── llms.txt ← AI crawler guidance
├── package-lock.json
├── package.json
├── README.md
├── SECURITY.md
└── TODO.md
Does ReFrame work with any game?
ReFrame works with any game that stores configuration in INI, CFG, XML, or JSON files. It ships with a knowledge base of 47 game profiles (Cyberpunk 2077, World of Warcraft, Counter-Strike 2, Apex Legends, Minecraft, Baldur's Gate 3, and more) across 16 engine profiles (UE4/UE5, Source 2, REDengine 4, Unity, and more). Use optimise <game name> and ReFrame will locate and analyse whatever configs it finds — even for titles without a dedicated profile.
Will ReFrame break my game or corrupt my save files?
No. ReFrame only modifies game configuration files and Windows registry settings — never save data. Every change is backed up to %LOCALAPPDATA%\ReFrame\Backups\ before being applied, and rollback <game> restores the original state in seconds.
How is ReFrame different from GeForce Experience, AMD Adrenalin, or MSI Afterburner? Those tools manage GPU driver settings. ReFrame targets the game's own configuration files and Windows system settings (HAGS, multimedia scheduler, power plan) — settings those tools do not touch. They complement each other rather than compete.
Does ReFrame work with Steam, Epic Games Store, and Xbox Game Pass titles?
Yes. ReFrame searches common installation paths for all three platforms. For games installed elsewhere, use analyse config <path> to point it directly at a config file.
Do I need administrator access? ReFrame runs without elevation for config file changes. Registry modifications that require Administrator are shown as ready-to-run PowerShell commands you can paste into an elevated terminal.
Does ReFrame require an internet connection?
No. The agent works entirely offline using your local knowledge base and system scan data. An internet connection is only needed for the initial git clone.
| Project | Description |
|---|---|
| Symdicate | Composable multi-agent framework for GitHub Copilot — persona grafting, cognitive identity caching, and agent fusion |
| vscode-copilot-sync | PowerShell toolkit to sync and manage Copilot agents, instructions, and skills from the awesome-copilot community catalogue |
| awesome-copilot | Community catalogue of Copilot agents, instructions, skills, hooks, and workflows |
See CONTRIBUTING.md.
For documentation and repo-housekeeping changes, run the spellcheck before opening a PR:
npm install
npm run spellcheckSee SECURITY.md for reporting vulnerabilities and installer verification guidance.