@shaykec/claude-teach

CLI engine and core logic for ClaudeTeach -- gamification, progress tracking, module registry, and marketplace.

This is the main entry point for the claude-teach command-line tool.

npm install -g @shaykec/claude-teach

Commands

Learning

| Command | Description | |---------|-------------| | list | List available modules (--category, --difficulty, --tag, --source) | | get <module> | Show module content (--quick, --quiz-only, --status, --reset) | | stats | Gamification dashboard | | level-up | Belt roadmap and recommendations |

Marketplace

| Command | Description | |---------|-------------| | install <url> | Install a module pack from git | | packs | List installed packs | | update <pack> | Update a pack (git pull) | | remove <pack> | Remove a pack | | search <query> | Search registries | | registry add\|list\|remove | Manage registries |

Authoring

| Command | Description | |---------|-------------| | author init <name> | Scaffold a new module pack | | author add <pack>/<module> | Add a module to a pack | | author validate <path> | Validate a pack | | author preview <path> | Preview a module locally | | registry:build | Rebuild the module registry |

System

| Command | Description | |---------|-------------| | serve | Start the bridge server (--port) | | inbox | Show browser-captured content |

Key Files

• src/cli.js -- Command definitions (Commander.js)
• src/registry.js -- Module registry (scans built-in, packs, local)
• src/progress.js -- Progress persistence (.teach-progress.yaml)
• src/gamification.js -- Belt calculation, XP logic, dashboard formatting
• src/marketplace.js -- Pack install/update/remove/search, registry config
• src/author.js -- Pack scaffolding, module addition, validation

Dependencies

• commander -- CLI framework
• js-yaml -- YAML parsing
• chalk -- Terminal colors
• @shaykec/bridge -- Bridge server
• @shaykec/shared -- Shared constants

See the root README for full documentation.