claude-sdk-tutor 0.1.0__py3-none-any.whl

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/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

claude_sdk_tutor-0.1.0.dist-info/METADATA

@@ -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.dist-info/RECORD

@@ -0,0 +1,8 @@
+app.py,sha256=rAnlcXNQmZiRiqixJISAkzSBWuBrPssjKbGuRngAOY8,4457
+claude/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+claude/claude_agent.py,sha256=8stg0rHC7g3b5CqS3EdvwkBMQqqZ0McHzlthMdIWlgE,1187
+claude_sdk_tutor-0.1.0.dist-info/METADATA,sha256=wHBRljVm9H5yuk74I3W03f5gJLUDJlatSUnq6GO2I80,2247
+claude_sdk_tutor-0.1.0.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+claude_sdk_tutor-0.1.0.dist-info/entry_points.txt,sha256=w-2yw_mHAwLUFSBVEKl_uQ9HnyYHd9c5glCrmgVeMyw,42
+claude_sdk_tutor-0.1.0.dist-info/licenses/LICENSE,sha256=KzxybQVVAEGBifrjNj5OGwQ_rsbzCIGPm0xrTL6-VZs,1067
+claude_sdk_tutor-0.1.0.dist-info/RECORD,,

claude_sdk_tutor-0.1.0.dist-info/WHEEL

@@ -0,0 +1,4 @@
+Wheel-Version: 1.0
+Generator: hatchling 1.28.0
+Root-Is-Purelib: true
+Tag: py3-none-any

claude_sdk_tutor-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+claude_tutor = app:main

claude_sdk_tutor-0.1.0.dist-info/licenses/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.