godspeed

godspeed is a study app for students and self-learners. Claude Code, Codex or any MCP app becomes your tutor: it checks what you already know, plans a path to your goal or exam, teaches one step at a time, then quizzes you. Every class gets its own lessons, files (PDFs, notes, lecture recordings), knowledge graph and exam prep. It runs on Mac, Windows and Linux, and needs no API keys.

godspeed is a fork of LearnHarness by Amos Blomqvist, and keeps its teaching method. The fork changes who teaches (an agent you already use) and adds classes, files, graphs and exams.

What's different from LearnHarness

The lesson screen was also rebuilt for speed. While the teacher writes, the screen redraws at most once per frame and only the message being written updates. Diagrams, code highlighting and the topic map load the first time you need them.

Related MCP server: MoeReview

How it works

1. Measure. The teacher finds where your understanding ends on each part the lesson depends on, from your answers, your confidence and what you type in the thinking box.

2. Plan. It maps the steps from there to your goal. The step bar shows where you are, and the plan changes when your answers say it should.

3. Teach. Each step builds on something you already understand. You predict, read the explanation, then check yourself. Confusions get fixed before anything is built on them.

4. Practice. Practice lessons pose varied problems that make you recall the right idea without being told which one it is.

Everything you learn is saved as facts and the reasoning chains between them, linked back to the lesson they came from. Later lessons read that graph instead of starting from zero.

Get started

Download godspeed for your computer:

• Mac with an Apple chip (M1 or newer): open the file, then drag godspeed into Applications.

• Windows: open the file. If Windows says "Windows protected your PC", click More info, then Run anyway. (The app isn't signed on Windows.)

• Linux: AppImage (most computers) or .deb (Ubuntu, Debian). Make the AppImage executable, then open it.

Each link downloads the newest version directly.

The app checks for updates once a day and installs them when you quit. Settings → General → Check for updates checks right away.

The first launch walks you through connecting your agent (below). You can find the same steps later under Settings → Connection.

To build it yourself instead: npm install, then npm run desktop:local (an unsigned Mac app in dist/) or npm run dev (http://localhost:3000).

Outside agents (MCP)

While godspeed is open it runs an MCP server, and an agent you already use is its teacher. The agent also does the background jobs: research, diagrams, PDF reading and building your knowledge graph. If no agent is connected, that work waits and starts when one connects.

1. Connect your agent:

   • Claude Code: /plugin marketplace add bayshores/godspeed, then /plugin install godspeed@godspeed, then /godspeed:teach (add a topic to start a new lesson). /godspeed:setup-classes builds your classes from your course files.

   • Codex: paste the config snippet from Settings → Connection into ~/.codex/config.toml.

   • Other MCP apps: use the address and token shown under Settings → Connection (Streamable HTTP, Authorization: Bearer <token>).

2. Start a lesson. You answer in the godspeed window and the agent teaches.

While you think, the Claude Code plugin waits in a background script, so the agent spends no tokens until you answer. Agents can also list and read lessons, search your graph, import notes, and manage classes and exams. Only programs on your computer that hold the token can connect.

Your plans, your data

• The AI is your own agent, on the plan you already pay for. godspeed has no subscription or markup of its own.

• Lessons, graphs, class files and settings stay on your machine as plain files you can read.

• Each task sends the context it needs to your agent, and web research fetches pages. Local storage doesn't mean offline.

• System prompts are visible and editable.

Development

npm test             # deterministic: no LLM, no network
npm run typecheck
npm run lint

See the development guide and architecture. Bugs and requests go to GitHub Issues.

License

AGPL-3.0. godspeed is based on LearnHarness, copyright its authors, and is distributed under the same license.