Installing

All users need Claude Code and Node.js 22+ with npm for this install. It works on macOS, Linux and Windows. Install Node if you need it.

Install Eklavya in a terminal.
Terminal window
```
npm install -g eklavya && eklavya install
```
This installs the plugin, local runtime and terminal command. Eklavya starts with its defaults and keeps any settings you already saved. New installs use claude-sonnet-5 for memory summaries and prompt feedback through your Claude Code login. What gets sent to Claude.

Allow Eklavya’s tools if you use auto mode.

Auto mode judges every tool call Eklavya makes on its own, and a plugin cannot allow itself. Without these entries it can refuse the call that plans your next question, so no question or side panel appears. Add them once.

Option 1: let Claude do it. Start a new Claude Code session, paste this prompt and press Enter. Claude edits ~/.claude/settings.json and keeps your existing entries. Then restart Claude Code once more so it reloads the file.

Eklavya's tools are being denied by auto mode. Add mcp__plugin_eklavya_eklavya__panel_sync, mcp__plugin_eklavya_eklavya__panel_answer, mcp__plugin_eklavya_eklavya__present_question, mcp__plugin_eklavya_eklavya__log_session_concepts, mcp__plugin_eklavya_eklavya__get_session_quiz_plan, mcp__plugin_eklavya_eklavya__record_attempt, mcp__plugin_eklavya_eklavya__upsert_concepts, mcp__plugin_eklavya_eklavya__get_learner_profile, mcp__plugin_eklavya_eklavya__memory_search and mcp__plugin_eklavya_eklavya__memory_get to permissions.allow in my ~/.claude/settings.json, keeping my existing entries.

Option 2: edit the file yourself

Add these ten entries to permissions.allow in ~/.claude/settings.json, keeping all existing entries.

{
  "permissions": {
    "allow": [
      "mcp__plugin_eklavya_eklavya__panel_sync",
      "mcp__plugin_eklavya_eklavya__panel_answer",
      "mcp__plugin_eklavya_eklavya__present_question",
      "mcp__plugin_eklavya_eklavya__log_session_concepts",
      "mcp__plugin_eklavya_eklavya__get_session_quiz_plan",
      "mcp__plugin_eklavya_eklavya__record_attempt",
      "mcp__plugin_eklavya_eklavya__upsert_concepts",
      "mcp__plugin_eklavya_eklavya__get_learner_profile",
      "mcp__plugin_eklavya_eklavya__memory_search",
      "mcp__plugin_eklavya_eklavya__memory_get"
    ]
  }
}

They cover the quiz loop, the side panel and memory recall, and touch only Eklavya’s own local data. Tools that change settings or delete memory are left out on purpose.

Restart Claude Code and start a task.

Ask Claude to build or change something. Eklavya asks short questions about the work and remembers it for your next session.

Read Your first session for what happens next. For other hosts, use Installation options. For more install details, see the FAQ.

Optional: check the installation

eklavya doctor

This checks the runtime, database and plugin. If it reports a problem, follow Troubleshooting.