Fix bug and improve error handling in todo agent

.python-version

@@ -0,0 +1 @@
+3.11

README.md

@@ -36,6 +36,8 @@ A progressive tutorial that demystifies AI coding agents like Kode, Claude Code,
 
 ## Quick Start
 
+### With pip
+
 ```bash
 pip install anthropic python-dotenv
 
@@ -51,6 +53,27 @@ python v3_subagent.py    # + Subagents
 python v4_skills_agent.py # + Skills
 ```
 
+### With uv (recommended)
+
+```bash
+# Install uv if you haven't already
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# Install dependencies and run
+uv add anthropic python-dotenv
+
+# Configure your API
+cp .env.example .env
+# Edit .env with your API key
+
+# Run any version
+uv run python v0_bash_agent.py  # Minimal
+uv run python v1_basic_agent.py # Core agent loop
+uv run python v2_todo_agent.py  # + Todo planning
+uv run python v3_subagent.py    # + Subagents
+uv run python v4_skills_agent.py # + Skills
+```
+
 ## The Core Pattern
 
 Every coding agent is just this loop:

README_zh.md

@@ -36,6 +36,8 @@
 
 ## 快速开始
 
+### 使用 pip
+
 ```bash
 pip install anthropic python-dotenv
 
@@ -51,6 +53,27 @@ python v3_subagent.py    # + 子代理
 python v4_skills_agent.py # + Skills
 ```
 
+### 使用 uv（推荐）
+
+```bash
+# 如果还没有安装 uv
+curl -LsSf https://astral.sh/uv/install.sh | sh
+
+# 安装依赖并运行
+uv add anthropic python-dotenv
+
+# 配置 API
+cp .env.example .env
+# 编辑 .env 填入你的 API key
+
+# 运行任意版本
+uv run python v0_bash_agent.py  # 极简版
+uv run python v1_basic_agent.py # 核心 Agent 循环
+uv run python v2_todo_agent.py  # + Todo 规划
+uv run python v3_subagent.py    # + 子代理
+uv run python v4_skills_agent.py # + Skills
+```
+
 ## 核心模式
 
 每个 Agent 都只是这个循环：

pyproject.toml

@@ -0,0 +1,12 @@
+[project]
+name = "learn-claude-code"
+version = "0.1.0"
+description = "Add your description here"
+readme = "README.md"
+requires-python = ">=3.11"
+dependencies = [
+    "anthropic>=0.75.0",
+    "dotenv>=0.9.9",
+    "numpy>=2.4.0",
+    "pygame>=2.6.1",
+]