tutor

Tutor Plugin for Claude Code

AI-powered tutoring with intelligent project suggestions, project-based learning, adaptive learning, exam preparation, and smart study planning.

Features • Installation • Quick Start • Project-Based Learning • Learning Contexts • Commands • Exam Preparation • How It Works

Features

AI Project Suggestions (New in 3.3.0)

• Skill-Based Suggestions — Tell the AI what you want to learn, get portfolio-ready projects
• Career Goal Matching — Preparing for interviews? Get projects that cover common topics
• Portfolio Optimization — Projects designed to impress on GitHub
• Multiple Options — Choose from 2-4 suggested projects tailored to your goals

Core Learning

• Any Subject — Programming, math, sciences, languages, history, and more
• Spaced Repetition — SM-2 algorithm for optimal memory retention
• Misconception Tracking — Identifies and addresses recurring errors
• Prerequisites Check — Ensures you have the foundation before advancing
• Adaptive Difficulty — Adjusts based on your performance

University & Exam Focus

• Exam Preparation — Simulations with 8 question types, adaptive strategies
• Dynamic Study Plans — Auto-adjusts based on exam dates and available time
• Syllabus Management — Import, add, and track your course syllabus
• Calendar Export — Google Calendar, Apple Calendar, Outlook, .ics

Learning Modes

• Learn — New content with explanations and examples
• Reinforce — Strengthen what you know with SRS and targeted practice
• Extend — Go deeper into mastered topics

Personalization

• Learning Styles — Visual, practical, theoretical, mixed, or auto-detect
• Multiple Contexts — University, research, certification, self-taught, and more
• Gamification — XP, badges, streaks, and weekly challenges

Installation

Option A: From Marketplace (recommended)

# In Claude Code, run:
/plugin marketplace add hsantos/tutor-plugin
/plugin install tutor@hsantos-tutor-plugin

The plugin will be installed automatically with all dependencies.

Option B: From local path

If you have the plugin cloned locally:

# In Claude Code, run:
/plugin install /path/to/tutor-plugin

Option C: From GitHub URL

# In Claude Code, run:
/plugin install https://github.com/hsantos/tutor-plugin

Verify Installation

After installation, restart Claude Code and run:

/tutor:init

If everything is configured correctly, you'll see the initialization wizard.

git clone https://github.com/hsantos/tutor-plugin

{
  "mcpServers": {
    "tutor-tools": {
      "command": "/bin/bash",
      "args": ["/path/to/tutor-plugin/server/run_server.sh"],
      "env": {
        "TUTOR_PLUGIN_ROOT": "/path/to/tutor-plugin"
      }
    }
  }
}

/plugin list  # Check installed plugins

# Test the server manually
cd /path/to/tutor-plugin/server
bash run_server.sh

# Remove venv and let it recreate
rm -rf /path/to/tutor-plugin/server/.venv

Quick Start

# Initialize your learning project
/tutor:init

# Check your daily dashboard (recommended entry point)
/tutor

# Start learning
/tutor:learn binary-trees

# Practice
/tutor:exercise

# Prepare for an exam
/tutor:exam-prep

Learning Contexts

The tutor adapts to your learning situation: