GM-Apprentice is a set of skills: instructions and small scripts that an AI
agent follows when you ask it for help with your game. The skills are free
and open source. You bring the agent. The easiest is a paid Claude or
ChatGPT plan, and that's what this page sets up, but any agent that takes
skills will run them, including one on a model on your own computer.
This page gets you from nothing to an installed
plugin. If you already have it installed, skip to
Start a new game or Start from your notes.
Have Claude Code, Codex, Cursor or another coding agent already? Open
it in any folder and paste this line:
Fetch https://raw.githubusercontent.com/AntTheLimey/gm-apprentice/main/INSTALL.md with curl and follow it.
The agent:
checks Python, and Node if you want a campaign website,
installs GM-Apprentice the way your agent takes plugins or skills,
runs a health check,
tells you what to say next.
The steps it follows are in
INSTALL.md:
read them first if you like to know what will run. Keep the words "with
curl": some agents' own page readers summarise a page, and a summary can
garble the commands.
Here is the end of a real run in Claude Code, on a Mac that had an older
version installed:
The apprentice
gm-apprentice is installed and up to date at version 1.12.108 (updated
from 1.12.105).
Install check:
ok Python 3.14.4
ok gm-apprentice 1.12.108, the Claude Code plugin
ok Node 25.5.0
ok the publish tool 1.70.43
Ready.
[...]
Next steps:
The skills load in a new session. To use them in this one, run
/reload-plugins.
Then say "help me start a new campaign".
If the check prints a line marked fail, the agent tells you what it
says and stops; fix that and paste the line again.
Then skip to Now pick a path. New to all this, or using
Cowork? Read on.
A ChatGPT plan that includes Codex, Plus or above (ChatGPT pricing)
already have another agent, or run a model locally
Cursor, Gemini CLI, OpenCode or another agent that takes skills (the list)
That agent, set up and working. These pages don't cover setting one up
Claude Code, Codex and Cursor have been tested end to end. The others
install the same way but haven't been tested yet. Prep and wrap-up are
long jobs that ask a lot of a model, so a small local model may struggle
with them.
They all run the same skills on the same campaign folder, so you can
switch later without losing anything. Your campaign lives in ordinary
Markdown files on your own computer, which Obsidian
(free) shows as a linked wiki. Obsidian is optional but recommended.
The skills' scripts need Python 3.10 or newer. If you let your agent
do the install (above), it checks this first and tells you if it's
missing or too old.
Mac: the python3 a Mac comes with is 3.9, which is too old.
Install the latest from python.org,
or with Homebrew: brew install python. Then, in a new Terminal
window, python3 --version should print 3.10 or higher.
Windows: install the latest Python from the Microsoft Store.
Its python3 is the one the skills call; the python.org installer
gives you only python and py.
You'll also want Node (22.21 or newer) if you plan a
campaign website, or if your agent installs with npx (the "any other
agent" route). Cowork, Claude Code and Codex need nothing else.
New releases come often. To move to the latest, in a terminal:
Claude Code:claude plugin marketplace update gm-apprentice, then
claude plugin update gm-apprentice@gm-apprentice --scope user, then
start a new session.
Codex:codex plugin marketplace upgrade gm-apprentice, then the
codex plugin add line above again.
Any other agent:npx skills update -g.
Your campaign folders need no separate step: when newer skills open an
older vault, they ask to update it, and do it for you.
If your agent did the install, it ran the health check for you: "Ready."
means you're set. After an install by hand, make an empty folder for your
campaign, open your agent in it, and ask:
You type
What GM-Apprentice skills do you have?
It should list the Midwife, session prep, wrap-up and the rest. You don't
need to remember their names: from here on you just say what you want, and
the agent picks the skill.