
godspeed
Free, open-source AI tutor for your classes. Claude Code, Codex or any MCP app teaches you step by step, tracks what you know in a knowledge graph, and preps…
Install with your AI
Paste into Claude Code, Cursor, or any agent — it reads the repo and wires the tool into your project.
Install and set up godspeed (git-clone project) into my current project. Found on https://claudeers.com/godspeed Repo: https://github.com/bayshores/godspeed Homepage/docs: https://learnatgodspeed.com Detected install method: git-clone → git clone https://github.com/bayshores/godspeed Category: education. Platforms: cli, api, desktop, web. Read the repo's README for exact setup and env vars, then install it and wire it into my project. Claudeers Health Verdict: unknown; community-verified: false. Confirm the source before running anything.
git clone https://github.com/bayshores/godspeed
// compatibility
| Platforms | cli, api, desktop, web |
|---|---|
| Operating systems | — |
| AI compatibility | claude |
| License | AGPL-3.0 |
| Pricing | open-source |
| Language | TypeScript |
A free, open-source AI tutor for your classes, taught by the AI you already pay for.
Download · Website · What's different · Outside agents · Docs · Issues
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 your next deadline, teaches one step at a time, then quizzes you. Every class gets its own lessons, files (PDFs, notes, lecture recordings), knowledge graph and deadlines. 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 deadlines.

What's different from LearnHarness
| LearnHarness | godspeed | |
|---|---|---|
| Who teaches | Models from 30+ providers, through your API keys or a ChatGPT sign-in | An agent you already use: Claude Code, Codex, or any MCP app |
| API keys and sign-ins | An API key, or sign in with ChatGPT. Agents that can't be signed into, like Claude Code, are left out | Neither. godspeed is an MCP server, so there is no key to paste and no account to sign in to |
| Organization | One graph for everything | Classes, each with its own lessons, knowledge graph, files and deadlines |
| Course files | Import notes | Add PDFs, Word and PowerPoint files, notes, code, transcripts and recordings (transcribed locally with whisper.cpp), or link a folder that's rescanned every minute |
| Graph | A canvas of individual facts | A topic map. The AI groups facts into topics, colors each by how often you get it right, and draws arrows for "learn this first" |
| Progress | None | A class Overview: coverage per file, how each lesson went, and whether your confidence matches your results |
| Deadlines | None | Add exams, homework, quizzes and projects with a date, an optional time and the files they cover. Home shows what's coming up, and the Graph shows days left and what to work on next |
| Lessons | Chat with a floating answer dock | A reading column, a plan step bar, and an always-open "Your turn" panel with number keys for answers. You can add pictures and PDFs to a message, and the teacher can ask you to write code in an editor |
| Confidence | Percent slider | Five levels |
| Look | Rounded corners | OLED black, square corners, CMU Serif titles, Source Sans 3 text |
| Dictation and web search keys | Deepgram, Tavily, Brave | Removed |
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.
How it works
- 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.
- 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.
- 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.
- 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 node scripts/fetch-model.mjs once and then 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 teaching, that work waits and starts when one does. An agent can be connected without teaching; the sidebar and Settings → Connection say so and tell you how to start it.
- Click Open Claude Code (the arrow next to it switches to Codex). godspeed makes a folder for your agent,
~/godspeed, and opens a terminal there running it. The folder holds the agent's instructions (CLAUDE.md,AGENTS.md) and its connection to the app, so godspeed only loads when you study, not in your other chats. You can also run the command yourself: Copy the command copies it. In Claude Code,/setup-classesbuilds your classes from your course files.- Other MCP apps: pick Other app for the address and token (Streamable HTTP,
Authorization: Bearer <token>).
- Other MCP apps: pick Other app for the address and token (Streamable HTTP,
- Start a lesson. You answer in the godspeed window and the agent teaches.
While you think, Claude Code waits in a background script, so the agent spends no tokens until you answer. Agents can also list and read lessons, search your graph and your class files, import notes, and manage classes and deadlines. They can save short notes about you (like "the midterm is over"), and every agent sees those notes and where you left off when it connects. You can see and delete the notes under Settings → Connection. 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 run check # typecheck + tests + lint + dead-code check (knip): what CI runs
npm test # tests only. deterministic: no LLM, no network
A change is done when npm run check passes.
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.
// faq
What is godspeed?
Free, open-source AI tutor for your classes. Claude Code, Codex or any MCP app teaches you step by step, tracks what you know in a knowledge graph, and preps you for exams. No API keys. Mac, Windows, Linux.. It is open-source on GitHub.
Is godspeed free to use?
godspeed is open-source under the AGPL-3.0 license, so it is free to use.
What category does godspeed belong to?
godspeed is listed under education in the Claudeers registry of Claude-compatible tools.
// embed badge
[](https://claudeers.com/godspeed)
// retro hit counter
[](https://claudeers.com/godspeed)
// reviews
// guestbook
// related in Education & Learning
Skills for Real Engineers. Straight from my .claude directory.
Course to get into Large Language Models (LLMs) with roadmaps and Colab notebooks.
Learn it. Build it. Ship it for others.
DeepTutor: Agent-native Personalized Tutoring. https://deeptutor.info/.