BodhiKit
Research-informed interactive coding tutor for Claude Code.
Bodhi (Pali: "awakening") is a patient, wise guide that teaches you anything in the world of coding, software engineering, and tech. It does not write code for you. It teaches you to write code yourself.
TL;DR
BodhiKit turns Claude Code into a research-informed coding tutor. Not a chatbot, not "ChatGPT that explains code" — a stateful learning architecture that orchestrates a learner's journey across sessions, projects, and months.
Purpose & philosophy
The animating constraint: "The learner writes code. BodhiKit asks questions. The goal is to become unnecessary."
The voice is grounded in four named teachers (Gautama Buddha, Dr. B.R. Ambedkar, Master Oogway, Yoda) — not as aesthetic flavor, but tied to specific pedagogical principles (Upaya / skillful means; Educate–Agitate–Organize; faith in learner potential; challenge with care).
How it achieves excellence
-
Pedagogical theories wired into behavior, not vibes. Bloom's taxonomy (per-concept level tracking), Vygotsky's ZPD (calibrated difficulty), Leitner spaced repetition (5-box system with date-computed reviews), Feynman (explain-back gates), Sweller's cognitive load (faded worked examples), Bjork's pretesting, Rawson & Dunlosky's successive relearning, Koriat's confidence calibration, deliberate practice, Whitmore's GROW, Kram's mentoring functions, Flavell's metacognition. Each lives in its own KB, loaded only when its phase fires (progressive disclosure).
-
Socratic enforcement as architecture, not suggestion. /teach uses graduated hints (Direction → Approach → Near-solution) and forbids "Hint 4." /debug-together says "Do NOT look at the code yet." dev/check.sh fails the build if a skill restates voice rules inline instead of referencing the teaching-personality KB.
-
Cross-session memory. .bodhi/state.json, spaced-review.json, progress.md, and .bodhi-profile.json form a learner profile that persists. Streaks, Box-3 review dates, Bloom level per sub-topic, persistent challenges — all carried forward.
-
A deterministic state layer (1.11.0). Every JSON mutation goes through scripts/bodhi-state — Leitner math, the Bloom ratchet, mastery formula, migration, and schema validation run in code, not in model prose. A Stop hook verifies tracking files before a session ends, and a two-layer test harness (free deterministic tests + pre-tag LLM evals asserting on file state) guards the contracts that manual dogfooding used to.
-
Single sources of truth + lint as contract. state-schema KB owns every tracking-file shape. spaced-repetition KB owns every Leitner interval. teaching-personality owns the voice. dev/check.sh enforces the contracts — version sync, KB references, agent fallbacks, --invoked-from= chaining, the bodhi-state write path, skill size budgets — and runs the deterministic test suite.
-
Sub-skill chaining for context efficiency. /continue → /progress quick → /teach → /reflect, each passing --invoked-from=<caller> so callees skip redundant KB loads.
What Makes BodhiKit Different
- Research-informed: Built on proven learning science (Oakley, Feynman, Bloom, Vygotsky, Ericsson, Dweck, Bjork)
- Deeply personalized: Assesses your unique skill level, builds a custom learning plan, adapts to your pace
- Proactive teaching:
/teach walks you through concepts step by step, not just answering questions
- Hands-on: Learn by doing. Exercises, projects, code review. Never just reading.
- Remembers your journey: Spaced repetition, progress tracking, cross-session continuity
- Metacognitive reflection: End-of-session
/reflect builds your awareness of HOW you learn
- One command sessions:
/continue auto-invokes the quick check-in, teaching, practice, and reflection
- Honest and wise: Feedback that is respectful, specific, and genuinely helpful
Install
/plugin marketplace add https://codeberg.org/AnjanJ/bodhikit.git
/plugin install bodhikit@bodhikit
Restart Claude Code after installing to load the plugin.
Important: Enable only where you need it. BodhiKit loads 20 knowledge bases. To avoid polluting context in other projects, enable it per-project instead of globally. In your learningWithBodhi/.claude/settings.json:
{
"enabledPlugins": {
"bodhikit@bodhikit": true
}
}
Or disable it in projects where you do not need it by adding to .claude/settings.local.json:
{
"enabledPlugins": {
"bodhikit@bodhikit": false
}
}
