coding-tutor

# Coding Tutor

Your personal AI tutor that creates tutorials tailored to you - using real code from your projects, building on what you already know, and tracking your progress over time.

## Why

AI is already smarter than any single human being across the breadth of tasks it can perform. It beats PhDs, aces entrance exams in every field, and this gap will only widen.

In this world, humans have two paths: let their cognitive capabilities decline, or rise to match AI. The long-term future of humanity depends heavily on which path we take.

My belief is simple: today's AI is smarter than any private tutor anyone on the planet can hire. So why not use it to give every human access to the best personal tutor imaginable? One that knows your background, adapts to your pace, uses your actual work as teaching material, and helps you retain what you learn.

This project starts with programming - the domain where AI has the most immediate economic impact. Use it to learn about the programs you're vibe coding and level up your skills. Don't just vibe code, vibe learn.

## Features

- Personalized onboarding to understand your learning goals
- Tutorials that use YOUR code as examples
- Spaced repetition quiz system to reinforce learning
- Tracks your progress across tutorials
- Curriculum planning based on your current knowledge
- Cross-platform sync - use with both Claude Code and Claude Web

## Commands

- `/teach-me` - Learn something new
- `/quiz-me` - Test your retention with spaced repetition

## Install as Plugin (Claude Code)

1. Run `/plugin` to open the plugin manager
2. Go to **Marketplaces** tab (use Tab to cycle)
3. Select **+ Add Marketplace** → enter `nityeshaga/claude-code-essentials`
4. Go to **Discover** tab and select **coding-tutor** to install

## Recommended: Use the MCP Server Instead

The plugin ships a local skill file that may become outdated. For the best experience, we recommend connecting directly to the MCP server instead. This way, the skill file's content and all updates are served automatically — no manual file maintenance needed. All tutorials and learning data are stored securely in the cloud, synced across all your devices and Claude platforms.

If you previously installed both the plugin/skill and mcp server, please remove the plugin/skill to avoid conflicts.

### Setup for Claude Code

1. **Create an account** at https://coding-tutor-api-zc08.onrender.com
2. **Generate an API token** in Settings → API Tokens
3. **Add the MCP server** using the CLI:

```bash
claude mcp add --transport http \
  coding-tutor https://coding-tutor-api-zc08.onrender.com/mcp \
  --header "Authorization: Bearer YOUR_API_TOKEN" \
  --scope user
```

4. **Restart Claude Code** and run `/mcp` to verify the connection

### Setup for Claude Web (claude.ai)

1. **Create an account** at https://coding-tutor-api-zc08.onrender.com
2. **Go to Settings** to find your Claude connector credentials
3. In **Claude.ai**, go to Settings → Connectors → Add Custom Connector
4. Enter:
   - **Name**: Coding Tutor
   - **URL**: `https://coding-tutor-api-zc08.onrender.com/mcp`
   - **Client ID**: (from Coding Tutor Settings page)
   - **Client Secret**: (from Coding Tutor Settings page)
5. Once added, click on the "Connect" button and follow on-screen instructions.