Welcome to Socrates

A Socratic AI teaching platform with gamification and visual learning.
Learn through guided dialogue — the AI asks YOU questions.

1

Getting Started

Launch Claude Code with teaching skills in one command:

socrates start

This starts the bridge server (for visuals) and launches Claude Code with all teaching skills loaded. You can also pass flags through:

socrates start -p "teach me git"
2

Teaching Skills

Once Claude Code is running with Socrates, these skills are available:

/teachSocratic teaching — learn any topic through guided dialogue
/teach:askAsk questions about any topic covered by learning modules
/teach:statsView your XP, belt rank, and module progress
/teach:level-upSee your belt roadmap and what to learn next
/teach:canvasOpen the visual canvas — diagrams, quizzes, dashboards
/teach:authorCreate a learning module with guided scaffolding
/teach:author-packCreate a complete module pack with multiple modules
/teach:devDeveloper workflow — run tests, validate, build
3

Chrome Extension

The Socrates extension adds context-aware learning suggestions, "Teach me this" right-click menus, and real-time connection to the visual canvas.

4

Visual Canvas

The bridge server powers browser-based visuals during lessons:

  • Mermaid diagrams and flowcharts
  • Interactive drag-and-drop quizzes
  • Timed multiple-choice challenges
  • Live code playgrounds
  • XP dashboard with belt progression
5

Quick Start

1
Run:
socrates start
2
In Claude Code, type:
/teach git
3
Follow the Socratic dialogue — you write the code, the AI guides you.