tritonsan/repog

RePoG is a downloadable workspace that turns an AI coding assistant like Codex or Claude Code into either a solo tabletop role playing game Game Master or a persistent AI companion character. Instead of installing a normal application, you download a ZIP file, extract it, open the folder in your coding assistant, and start a conversation telling it to begin RePoG. The assistant then reads the files inside the workspace to understand its role and starts guiding you through setup. There are two experiences to choose from. In RPG Campaign mode, the assistant acts as a Game Master, running scenes, non player characters, and an ongoing story, along with optional dice based mechanics and a player facing dashboard that shows character and world details as text based tiles. In AI Companion mode, the assistant instead plays one persistent fictional character with its own daily routine, relationships, and life, always staying honest when directly asked whether it is an AI. Setup for either mode is done through a short conversation called Session 0, offered in Quick, Standard, or Deep depth, ranging from around ten minutes to two hours, where you answer questions naturally and the workspace records your choices as campaign memory in plain text files. Under the hood, RePoG relies on rules encoded in its files rather than a separate model or paid API, meaning it uses whatever coding assistant you already opened it in, plus small deterministic local helper scripts that protect things like dice rolls, character stats, and timing so a character's story cannot randomly jump around or contradict itself. The project describes features such as reproducible dice, protection against duplicate or out of order actions, and a companion memory system that only stores personal details you consent to sharing, along with 317 automated tests covering these behaviors. This project is aimed at people who already use an AI coding tool like Codex or Claude Code and want a structured, private way to run a solo tabletop RPG campaign or maintain an ongoing AI companion character, rather than at general RPG players looking for a standalone app. The full README is longer than what was shown.