CourseCode Framework

Build LMS courses with Claude Code, Codex, or any AI tool that supports MCP.

CourseCode Framework is open source and runs on your computer. Your AI tool writes the course as regular project files you can inspect, version, and edit. CourseCode's MCP server lets it preview, screenshot, lint, and test what it built. Export SCORM 1.2, SCORM 2004, cmi5, or LTI 1.3.

Start from a topic or from your own PDFs, Word documents, and PowerPoint decks. No coding is required to start, and you have full control of the code when you want it.

View the demo

• View the live CourseCode demo course

CourseCode ecosystem

CourseCode Framework (this repository) is open source and works on its own. CourseCode Cloud is an optional paid hosting service for deploying and delivering courses.

Framework documentation lives at coursecodeframework.com/docs and in framework/docs/.

Features

• Works with your AI tool: Every new project includes MCP settings and workflow skills for Claude Code, Codex, Cursor, and VS Code. Any other MCP client can run coursecode mcp, and an optional plugin is available for Claude Code and Codex
• No coding required to start: Describe what you want and let AI help build slides, interactions, and structure
• Course modernization: Use existing SCORM courses, PowerPoints, PDFs, Word docs, scripts, and SME notes as source material for upgraded courses
• LMS integration: SCORM 1.2, SCORM 2004, and cmi5 packaging, plus an LTI 1.3 browser contract for trusted server-backed launches
• Rich UI components: Images, video, accordions, tabs, and custom sandboxed HTML/JS embeds
• Rich interactions: Multiple choice, drag-drop, fill-in-the-blank, matching, sequencing, and more
• Accessibility: Designed to meet WCAG 2.1 AA, with dark mode, high contrast, and reduced motion
• TTS audio narration: Built-in player with AI text-to-speech generation (Deepgram, ElevenLabs, OpenAI, Google Cloud, or Azure, using your own API key)
• Smart tracking: Engagement requirements, learning objectives, and progress persistence
• Themeable design: CSS custom properties for easy brand customization
• Custom endpoints: Optional webhooks for error reporting and learning record storage
• Live preview: Visual editing, status dashboard, config panels, catalog browser, and full LMS simulation with debug tools

---

Quick Start

You need Node.js 22.15 or later and an AI tool that can run commands, such as Claude Code, Codex, Cursor, or VS Code with GitHub Copilot. Your AI tool can install Node.js for you.

1. Create an empty folder for your course and start your AI tool in it.

2. Paste this:

   Set up a CourseCode Framework course in this folder. Check that Node.js 22.15 or later is installed and help me install it if it isn't. Then run `npx coursecode@latest create .` and tell me what to do next.
   

3. When it's done, quit your AI tool and start it again in the same folder so it loads the CourseCode tools. Claude Code asks once to approve the coursecode server; Codex asks you to trust the folder.

4. Describe the course you want.

5. When the course is ready, ask your AI tool to export it for your LMS (SCORM 1.2, SCORM 2004, cmi5, or LTI 1.3), or to deploy it to CourseCode Cloud for hosting, share links, and analytics. Cloud is optional.

The project includes MCP settings for Claude Code, Codex, Cursor, and VS Code, an AGENTS.md with the authoring workflow, and four workflow skills (outline, build slides, review, publish). Nothing else needs installing, and no account is required.

Without an AI tool

npx coursecode@latest create my-course
cd my-course
npx coursecode preview

Open http://localhost:4173 to view and edit your course. The example course included with every new project is a complete guide to using CourseCode.

Claude Code and Codex plugin (optional)

The plugin runs the CourseCode tools in every folder, so your AI tool can start a course before a project exists. You don't need it, because projects already include the tools and skills. Install it from this repository:

# Claude Code
claude plugin marketplace add course-code-framework/coursecode
claude plugin install coursecode@coursecode

# Codex
codex plugin marketplace add course-code-framework/coursecode
codex plugin add coursecode@coursecode

See plugin/README.md. Start with the User Guide for a complete walkthrough.

---

Requirements

Node.js 22.15 or later. You can run every command through npx coursecode, or install the CLI globally for the shorter coursecode command used in the rest of this guide:

npm install -g coursecode

Learner courses support Chrome 111+, Edge 111+, Firefox 114+, and Safari 16.4+. SCORM compatibility describes LMS communication and packaging; it does not imply Internet Explorer support.

Also recommended:

• A code or text editor, such as VS Code, Cursor, or similar
• An AI coding tool with MCP support, such as Claude Code, Codex, Cursor, or VS Code with GitHub Copilot
• GitHub Desktop for version control

---

MCP Integration

CourseCode includes a built-in Model Context Protocol (MCP) server. When your AI tool supports MCP, it connects directly to your course project, so you don't have to paste files into a chat.

This is the beginning of the README. Read the rest at the original. Read the full README ↗