Claude Tutor
A terminal-based programming tutor powered by Claude. Built with Textual and the Claude Agent SDK.
Features
- Tutor Mode - Claude guides your learning instead of writing code for you
- Web Search - Optional online lookup capability
- MCP Servers - Extend Claude with external tools via Model Context Protocol
- Command History - Navigate previous commands with up/down arrows (persisted across sessions)
- Query Interruption - Cancel long-running queries with Escape or Ctrl+C
- File Access - Claude can read files in your codebase to provide contextual help
Overview
Claude Tutor is a TUI (Terminal User Interface) application designed to help you learn programming concepts. Unlike a typical coding assistant, Claude Tutor focuses on teaching rather than writing code for you. It will:
- Explain concepts clearly and thoroughly
- Guide you toward understanding with questions and hints
- Provide small examples to illustrate concepts
- Encourage you to write code yourself
- Review code you share, pointing out what works well and what could be improved
Installation
uv sync
Or install from PyPI:
uvx claude_tutor
Running
uv run python app.py
Using the TUI
When you launch Claude Tutor, you'll see a simple interface with:
- A welcome header at the top
- A chat log area in the middle showing your conversation
- A text input field at the bottom for typing messages
Type your programming questions in the input field and press Enter to send. Claude's responses will appear in the chat log. The interface uses color-coded panels to distinguish between different message types:
- Blue - Your messages
- Red - Claude's responses
- Grey - Tool usage (when Claude reads files in your codebase)
- Green - Slash command feedback
Keyboard Shortcuts
| Key | Action |
|---|---|
Enter |
Send message |
Up / Down |
Navigate command history |
Escape or Ctrl+C |
Cancel running query |
Command history is automatically saved between sessions.
Slash Commands
| Command | Description |
|---|---|
/help |
Shows a list of available commands. |
/clear |
Clears the conversation history and starts fresh. Your settings are preserved. |
/tutor |
Toggles tutor mode on/off. When on (default), Claude acts as a teacher. When off, Claude responds normally without the tutoring constraints. |
/togglewebsearch |
Toggles web search on/off. When on, Claude can use WebSearch and WebFetch tools to look up information online. Disabled by default. |
/mcp |
Manage MCP servers. Use /mcp help for detailed subcommands. |
MCP Server Support
Claude Tutor supports Model Context Protocol (MCP) servers, allowing you to extend Claude's capabilities with external tools.
MCP Commands
| Command | Description |
|---|---|
/mcp list |
List all configured servers with connection status |
/mcp test [name] |
Test MCP server connections |
/mcp add |
Add a new server (interactive wizard) |
/mcp add <name> <type> <cmd|url> [args] |
Add server directly |
/mcp remove <name> |
Remove a server |
/mcp enable <name> |
Enable a disabled server |
/mcp disable <name> |
Disable a server without removing it |
/mcp status [name] |
Show server configuration details |
Server Types
- stdio - Local process that communicates via stdin/stdout (e.g.,
npxpackages) - sse - Server-Sent Events endpoint
- http - HTTP endpoint
Example: Adding an MCP Server
/mcp add filesystem stdio npx -y @anthropic/mcp-filesystem
Or use the interactive wizard:
/mcp add
After adding or modifying servers, use /clear to reconnect with the updated configuration.
MCP server configurations are persisted to ~/.local/share/claude-sdk-tutor/mcp_servers.json.
Tech Stack
- Python 3.13+
- Textual - TUI framework
- Claude Agent SDK - Claude integration
- uv - Package manager
1 maintainer
Metadata
1 maintainer
Release files for claude-sdk-tutor 0.1.8
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| claude_sdk_tutor-0.1.8.tar.gz | 90.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| claude_sdk_tutor-0.1.8-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 105.4 kB
Release files / claude_sdk_tutor-0.1.8.tar.gz
| Download URL | claude_sdk_tutor-0.1.8.tar.gz |
|---|---|
| Size | 90.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a6924cfacd147473ae03f48f04a84289fd18cc80a9018d8dddf2c3cd49ad2eb4
|
|
BLAKE2b-256 checksum How to use checksums |
e45d0a7e95ed2aad098b8f3e125425d623ed4d072f589df922effb88d8ec9fbb
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / claude_sdk_tutor-0.1.8-py3-none-any.whl
| Download URL | claude_sdk_tutor-0.1.8-py3-none-any.whl |
|---|---|
| Size | 15.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
b15e8c94a603e09aa234c259737794c982c03980ed1efa67f5a267947b3b395f
|
|
BLAKE2b-256 checksum How to use checksums |
36525feb476a38fbbfc70272760ac9e32606c4462865ee22f49bae42b0e96992
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.28 {"installer":{"name":"uv","version":"0.9.28","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Debian GNU/Linux","version":"13","id":"trixie","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
