← DEV
Dev tool

Handzon

A CLI and framework for hands-on tutorial sites: lessons in MDX, checkpoints and quizzes that track progress, an AI tutor, and an MCP endpoint agents can work through.

The Render Tutorials listing: the title, the search row, and the first tutorial cards

Handzon builds hands-on tutorial sites. You run the CLI, write the lessons as MDX, and get an Astro site with checkpoints, quizzes, code examples, tabs and runnable playgrounds already wired up.

Progress lives in the browser by default, so a reader can leave and come back without an account. Add GitHub login and Postgres and it follows them across devices, and a workshop can see where each learner stopped.

Every generated site exposes an MCP endpoint, so an agent in Cursor, Claude Code or Codex can read a tutorial, start a workspace from it, and tick the checkpoints off as the work gets done. An optional AI tutor answers questions inside the lesson.

It ships as four npm packages: the CLI, the runtime, the AI service, and a stdio bridge for clients that cannot speak remote MCP. Two Render blueprints cover the deploy, one for a public site with progress in the browser, one that adds Postgres and the login.

Render Tutorials runs on it.