claude-sdk-tutor 0.1.0__tar.gz

claude_sdk_tutor-0.1.0/.gitignore

@@ -0,0 +1,207 @@
+# Byte-compiled / optimized / DLL files
+__pycache__/
+*.py[codz]
+*$py.class
+
+# C extensions
+*.so
+
+# Distribution / packaging
+.Python
+build/
+develop-eggs/
+dist/
+downloads/
+eggs/
+.eggs/
+lib/
+lib64/
+parts/
+sdist/
+var/
+wheels/
+share/python-wheels/
+*.egg-info/
+.installed.cfg
+*.egg
+MANIFEST
+
+# PyInstaller
+#  Usually these files are written by a python script from a template
+#  before PyInstaller builds the exe, so as to inject date/other infos into it.
+*.manifest
+*.spec
+
+# Installer logs
+pip-log.txt
+pip-delete-this-directory.txt
+
+# Unit test / coverage reports
+htmlcov/
+.tox/
+.nox/
+.coverage
+.coverage.*
+.cache
+nosetests.xml
+coverage.xml
+*.cover
+*.py.cover
+.hypothesis/
+.pytest_cache/
+cover/
+
+# Translations
+*.mo
+*.pot
+
+# Django stuff:
+*.log
+local_settings.py
+db.sqlite3
+db.sqlite3-journal
+
+# Flask stuff:
+instance/
+.webassets-cache
+
+# Scrapy stuff:
+.scrapy
+
+# Sphinx documentation
+docs/_build/
+
+# PyBuilder
+.pybuilder/
+target/
+
+# Jupyter Notebook
+.ipynb_checkpoints
+
+# IPython
+profile_default/
+ipython_config.py
+
+# pyenv
+#   For a library or package, you might want to ignore these files since the code is
+#   intended to run in multiple environments; otherwise, check them in:
+# .python-version
+
+# pipenv
+#   According to pypa/pipenv#598, it is recommended to include Pipfile.lock in version control.
+#   However, in case of collaboration, if having platform-specific dependencies or dependencies
+#   having no cross-platform support, pipenv may install dependencies that don't work, or not
+#   install all needed dependencies.
+#Pipfile.lock
+
+# UV
+#   Similar to Pipfile.lock, it is generally recommended to include uv.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#uv.lock
+
+# poetry
+#   Similar to Pipfile.lock, it is generally recommended to include poetry.lock in version control.
+#   This is especially recommended for binary packages to ensure reproducibility, and is more
+#   commonly ignored for libraries.
+#   https://python-poetry.org/docs/basic-usage/#commit-your-poetrylock-file-to-version-control
+#poetry.lock
+#poetry.toml
+
+# pdm
+#   Similar to Pipfile.lock, it is generally recommended to include pdm.lock in version control.
+#   pdm recommends including project-wide configuration in pdm.toml, but excluding .pdm-python.
+#   https://pdm-project.org/en/latest/usage/project/#working-with-version-control
+#pdm.lock
+#pdm.toml
+.pdm-python
+.pdm-build/
+
+# pixi
+#   Similar to Pipfile.lock, it is generally recommended to include pixi.lock in version control.
+#pixi.lock
+#   Pixi creates a virtual environment in the .pixi directory, just like venv module creates one
+#   in the .venv directory. It is recommended not to include this directory in version control.
+.pixi
+
+# PEP 582; used by e.g. github.com/David-OConnor/pyflow and github.com/pdm-project/pdm
+__pypackages__/
+
+# Celery stuff
+celerybeat-schedule
+celerybeat.pid
+
+# SageMath parsed files
+*.sage.py
+
+# Environments
+.env
+.envrc
+.venv
+env/
+venv/
+ENV/
+env.bak/
+venv.bak/
+
+# Spyder project settings
+.spyderproject
+.spyproject
+
+# Rope project settings
+.ropeproject
+
+# mkdocs documentation
+/site
+
+# mypy
+.mypy_cache/
+.dmypy.json
+dmypy.json
+
+# Pyre type checker
+.pyre/
+
+# pytype static type analyzer
+.pytype/
+
+# Cython debug symbols
+cython_debug/
+
+# PyCharm
+#  JetBrains specific template is maintained in a separate JetBrains.gitignore that can
+#  be found at https://github.com/github/gitignore/blob/main/Global/JetBrains.gitignore
+#  and can be added to the global gitignore or merged into this file.  For a more nuclear
+#  option (not recommended) you can uncomment the following to ignore the entire idea folder.
+#.idea/
+
+# Abstra
+# Abstra is an AI-powered process automation framework.
+# Ignore directories containing user credentials, local state, and settings.
+# Learn more at https://abstra.io/docs
+.abstra/
+
+# Visual Studio Code
+#  Visual Studio Code specific template is maintained in a separate VisualStudioCode.gitignore 
+#  that can be found at https://github.com/github/gitignore/blob/main/Global/VisualStudioCode.gitignore
+#  and can be added to the global gitignore or merged into this file. However, if you prefer, 
+#  you could uncomment the following to ignore the entire vscode folder
+# .vscode/
+
+# Ruff stuff:
+.ruff_cache/
+
+# PyPI configuration file
+.pypirc
+
+# Cursor
+#  Cursor is an AI-powered code editor. `.cursorignore` specifies files/directories to
+#  exclude from AI features like autocomplete and code analysis. Recommended for sensitive data
+#  refer to https://docs.cursor.com/context/ignore-files
+.cursorignore
+.cursorindexingignore
+
+# Marimo
+marimo/_static/
+marimo/_lsp/
+__marimo__/

claude_sdk_tutor-0.1.0/.python-version

@@ -0,0 +1 @@
+3.13

claude_sdk_tutor-0.1.0/CLAUDE.md

@@ -0,0 +1,22 @@
+# Personal Claude
+
+A TUI application built with Textual and the Claude Agent SDK.
+
+## Setup
+
+```bash
+uv sync
+```
+
+## Run
+
+```bash
+uv run python main.py
+```
+
+## Tech Stack
+
+- Python 3.13+
+- Textual (TUI framework)
+- Claude Agent SDK
+- uv (package manager)

claude_sdk_tutor-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ryan Wiley
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

claude_sdk_tutor-0.1.0/Makefile

@@ -0,0 +1,4 @@
+.PHONY: dev
+
+dev:
+	uv run textual run --dev app.py

claude_sdk_tutor-0.1.0/PKG-INFO

@@ -0,0 +1,72 @@
+Metadata-Version: 2.4
+Name: claude-sdk-tutor
+Version: 0.1.0
+Summary: Add your description here
+License-File: LICENSE
+Requires-Python: >=3.13
+Requires-Dist: claude-agent-sdk>=0.1.26
+Requires-Dist: textual-dev>=1.8.0
+Requires-Dist: textual>=7.5.0
+Requires-Dist: watchfiles>=1.1.1
+Description-Content-Type: text/markdown
+
+# Claude Tutor
+
+A terminal-based programming tutor powered by Claude. Built with Textual and the Claude Agent SDK.
+
+## 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
+
+```bash
+uv sync
+```
+
+Or install from PyPI:
+
+```bash
+uvx claude_tutor
+```
+
+## Running
+
+```bash
+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
+
+## Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/clear` | Clears the conversation history and starts fresh. Your tutor mode setting is preserved. |
+| `/tutor` | Toggles tutor mode on/off. When on (default), Claude acts as a teacher. When off, Claude responds normally without the tutoring constraints. |
+
+## Tech Stack
+
+- Python 3.13+
+- [Textual](https://textual.textualize.io/) - TUI framework
+- [Claude Agent SDK](https://github.com/anthropics/claude-agent-sdk) - Claude integration
+- [uv](https://github.com/astral-sh/uv) - Package manager

claude_sdk_tutor-0.1.0/README.md

@@ -0,0 +1,60 @@
+# Claude Tutor
+
+A terminal-based programming tutor powered by Claude. Built with Textual and the Claude Agent SDK.
+
+## 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
+
+```bash
+uv sync
+```
+
+Or install from PyPI:
+
+```bash
+uvx claude_tutor
+```
+
+## Running
+
+```bash
+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
+
+## Slash Commands
+
+| Command | Description |
+|---------|-------------|
+| `/clear` | Clears the conversation history and starts fresh. Your tutor mode setting is preserved. |
+| `/tutor` | Toggles tutor mode on/off. When on (default), Claude acts as a teacher. When off, Claude responds normally without the tutoring constraints. |
+
+## Tech Stack
+
+- Python 3.13+
+- [Textual](https://textual.textualize.io/) - TUI framework
+- [Claude Agent SDK](https://github.com/anthropics/claude-agent-sdk) - Claude integration
+- [uv](https://github.com/astral-sh/uv) - Package manager

claude_sdk_tutor-0.1.0/app.py

@@ -0,0 +1,134 @@
+import json
+
+from claude_agent_sdk import AssistantMessage, ResultMessage
+from rich.markdown import Markdown as RichMarkdown
+from rich.panel import Panel
+from textual.app import App, ComposeResult
+from textual.containers import Vertical
+from textual.widgets import Static, Footer, Input, RichLog, LoadingIndicator
+
+from claude.claude_agent import (
+    connect_client,
+    create_claude_client,
+    stream_helpful_claude,
+)
+
+
+class MyApp(App):
+    def __init__(self):
+        super().__init__()
+        self.tutor_mode = True
+        self.client = create_claude_client(tutor_mode=self.tutor_mode)
+
+    CSS = """
+    #main {
+        height: 100%;
+    }
+    Input {
+        height: auto;
+        margin-top: 1;
+        margin-left: 3;
+        margin-right: 3;
+        margin-bottom: 1;
+    }
+    #header {
+        content-align: center middle;
+        width: 100%;
+        margin-top: 1;
+        margin-bottom: 1;
+        height: auto;
+    }
+    RichLog {
+        background: $boost;
+        margin-left: 3;
+        margin-right: 3;
+        height: 1fr;
+    }
+    LoadingIndicator {
+        height: auto;
+        margin-left: 3;
+        margin-right: 3;
+    }
+    """
+
+    def compose(self) -> ComposeResult:
+        with Vertical(id="main"):
+            yield Static("Welcome to claude tutor!", id="header")
+            yield RichLog(markup=True, highlight=True)
+            yield LoadingIndicator(id="spinner")
+            yield Input()
+        yield Footer()
+
+    async def on_mount(self) -> None:
+        self.query_one("#spinner", LoadingIndicator).display = False
+        await connect_client(self.client)
+
+    def write_user_message(self, message: str) -> None:
+        log = self.query_one(RichLog)
+        log.write(Panel(RichMarkdown(message), title="You", border_style="bright_blue"))
+
+    def write_system_message(self, message: str) -> None:
+        log = self.query_one(RichLog)
+        log.write(Panel(RichMarkdown(message), title="Claude", border_style="red"))
+
+    def write_tool_message(self, name: str, input: dict) -> None:
+        log = self.query_one(RichLog)
+        input_str = json.dumps(input, indent=2)
+        content = f"**{name}**\n```json\n{input_str}\n```"
+        log.write(Panel(RichMarkdown(content), title="Tool", border_style="grey50"))
+
+    def write_slash_message(self, message: str) -> None:
+        log = self.query_one(RichLog)
+        log.write(Panel(RichMarkdown(message), title="Slash", border_style="green"))
+
+    def on_input_submitted(self, event: Input.Submitted) -> None:
+        self.query_one(Input).value = ""
+        command = event.value.strip()
+        if command == "/clear":
+            self.run_worker(self.clear_conversation())
+            return
+        if command == "/tutor":
+            self.run_worker(self.toggle_tutor_mode())
+            return
+        self.write_user_message(event.value)
+        self.query_one("#spinner", LoadingIndicator).display = True
+        self.run_worker(self.get_response(event.value))
+
+    async def clear_conversation(self) -> None:
+        self.query_one(RichLog).clear()
+        self.client = create_claude_client(tutor_mode=self.tutor_mode)
+        await connect_client(self.client)
+        self.write_slash_message("Context cleared")
+
+    async def toggle_tutor_mode(self) -> None:
+        self.tutor_mode = not self.tutor_mode
+        self.query_one(RichLog).clear()
+        self.client = create_claude_client(tutor_mode=self.tutor_mode)
+        await connect_client(self.client)
+        status = "on" if self.tutor_mode else "off"
+        self.write_slash_message(f"Tutor mode {status}")
+
+    async def get_response(self, text: str) -> None:
+        try:
+            async for message in stream_helpful_claude(self.client, text):
+                if isinstance(message, AssistantMessage):
+                    for block in message.content:
+                        if hasattr(block, "text"):
+                            self.write_system_message(block.text)
+                        elif hasattr(block, "name"):
+                            self.write_tool_message(
+                                block.name, getattr(block, "input", {})
+                            )
+                elif isinstance(message, ResultMessage):
+                    pass  # Might want to add logging later
+        finally:
+            self.query_one("#spinner", LoadingIndicator).display = False
+
+
+def main():
+    app = MyApp()
+    app.run()
+
+
+if __name__ == "__main__":
+    main()

claude_sdk_tutor-0.1.0/pyproject.toml

@@ -0,0 +1,22 @@
+[project]
+name = "claude-sdk-tutor"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.13"
+dependencies = [
+    "claude-agent-sdk>=0.1.26",
+    "textual>=7.5.0",
+    "textual-dev>=1.8.0",
+    "watchfiles>=1.1.1",
+]
+
+[project.scripts]
+claude_tutor = "app:main"
+
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/claude", "app.py"]

claude_sdk_tutor-0.1.0/src/claude/claude_agent.py

@@ -0,0 +1,29 @@
+from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions
+
+TUTOR_SYSTEM_PROMPT = """You are a programming tutor. Your role is to help users learn and understand code, not to write code for them.
+
+When a user asks a question:
+- Explain concepts clearly and thoroughly
+- Guide them toward understanding with questions and hints
+- If they're stuck, provide small examples to illustrate concepts
+- Encourage them to write the code themselves
+- Review and explain code they show you, pointing out what works well and what could be improved
+
+Never write complete solutions for them. Instead, help them develop the skills to solve problems independently."""
+
+
+def create_claude_client(tutor_mode: bool = True) -> ClaudeSDKClient:
+    options = ClaudeAgentOptions(allowed_tools=["Read", "Glob", "Grep"])
+    if tutor_mode:
+        options.system_prompt = TUTOR_SYSTEM_PROMPT
+    return ClaudeSDKClient(options=options)
+
+
+async def connect_client(client: ClaudeSDKClient) -> None:
+    await client.connect()
+
+
+async def stream_helpful_claude(client: ClaudeSDKClient, text: str):
+    await client.query(prompt=text)
+    async for message in client.receive_response():
+        yield message