Sensei

AI That Remembers How to Teach You

Claude is smart enough to be a great mentor. It just doesn't know who it's talking to.

Sensei gives Claude memory about you — your skill level, what you've learned, and what you're building.

You: "How do I handle errors in useEffect?"

Claude: [Checks Sensei]
        → Knows you understand promises, are learning React hooks
        → Knows you're building a fintech app with Supabase

Claude: "Since you're comfortable with try/catch from your async work,
        the pattern in useEffect is similar. For your Supabase queries..."

No more "First, let me explain what useEffect is..." every single time.

---

Quick Start

1. Add to Claude Code

Add this to your Claude Code MCP settings (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "sensei": {
      "command": "npx",
      "args": ["-y", "@sensei-mcp/sensei"]
    }
  }
}

2. Add the System Prompt

Copy the contents of PROMPT.md into your Claude Project's custom instructions.

This tells Claude how to use Sensei effectively.

3. Start Learning

That's it. Claude now remembers who you are.

---

What Sensei Tracks

Skills

Three levels. Simple.

Level	Meaning
unknown	Never discussed
learning	Covered basics, still developing
solid	Uses independently, understands well

Learning History

What Claude has taught you, so it can reference past explanations:

2025-01-14: explained "useEffect cleanup" (react-hooks)
2025-01-13: explained "async/await" (javascript)

Project Context

What you're building:

Project: fintech-app
Stack: React, TypeScript, Supabase
Notes: "REST API with row-level security"

Prerequisites

Before explaining X, Claude checks if you know the prerequisites:

useEffect requires:
├── react-hooks (concept of hooks)
├── closures (effects close over state)
└── side-effects (what effects are for)

Preferences

How you like explanations:

style: concise | detailed | example-heavy
languages: ["typescript", "python"]

---

Tools Reference

Tool	Purpose
sensei_get_context	Get everything: skills, history, project, preferences
sensei_get_skills	Get skill levels
sensei_set_skill	Update a skill level
sensei_log_learned	Record that a concept was taught
sensei_get_history	Get learning history
sensei_get_prerequisites	Check prerequisites for a concept
sensei_get_project	Get project context
sensei_set_project	Update project context
sensei_get_preferences	Get explanation preferences
sensei_set_preferences	Update preferences

---

Privacy

• All local. Data stored in ~/.sensei/sensei.db
• No cloud. No accounts. No telemetry.
• Your data. Export or delete anytime.

---

Development

# Clone
git clone https://github.com/your-username/sensei
cd sensei

# Install
npm install

# Build
npm run build

# Run locally
node dist/index.js

Project Structure

sensei/
├── src/
│   ├── index.ts          # MCP server entry
│   ├── db/               # SQLite database layer
│   │   ├── init.ts       # Database initialization
│   │   ├── skills.ts     # Skills CRUD
│   │   ├── history.ts    # History CRUD
│   │   ├── project.ts    # Project context
│   │   └── preferences.ts
│   └── tools/            # MCP tool handlers
│       ├── index.ts      # Tool registration
│       ├── handlers.ts   # Tool implementations
│       └── prerequisites.ts
├── knowledge/
│   └── prerequisites.json  # Concept prerequisite graph
├── PROMPT.md             # System prompt for Claude
└── README.md

---

Contributing

The most valuable contributions are to the prerequisite graph.

# Edit knowledge/prerequisites.json
# Add your domain expertise

{
  "kubernetes-pods": ["docker", "containers", "yaml"],
  "graphql-resolvers": ["graphql-schema", "async-await"]
}

---

Why "Sensei"?

先生 (sensei) — "one who comes before"

A teacher who remembers where you've been and guides where you're going.

---

License

MIT

---

<p align="center"> <strong>Sensei: AI That Remembers How to Teach You</strong> </p>