todo-agent 0.2.8__py3-none-any.whl → 0.3.1__py3-none-any.whl

todo_agent/interface/tools.py

@@ -6,11 +6,11 @@ AVAILABLE TOOLS:
 Discovery Tools (Call FIRST):
 - list_projects() - Get all available projects from todo.txt
 - list_contexts() - Get all available contexts from todo.txt
-- list_tasks(filter?) - List current tasks with optional filtering
-- list_completed_tasks(filter?, project?, context?, text_search?, date_from?, date_to?) - List completed tasks with optional filtering
+- list_tasks() - List all current tasks from todo.txt
+- list_completed_tasks() - List all completed tasks from done.txt
 
 Task Management Tools:
-- add_task(description, priority?, project?, context?, due?) - Add new task to todo.txt
+- add_task(description, priority?, project?, context?, due?, recurring?) - Add new task to todo.txt
 - complete_task(task_number) - Mark task as complete by line number
 - replace_task(task_number, new_description) - Replace entire task content
 - append_to_task(task_number, text) - Add text to end of existing task
@@ -20,12 +20,16 @@ Task Management Tools:
 Priority Management Tools:
 - set_priority(task_number, priority) - Set or change task priority (A-Z)
 - remove_priority(task_number) - Remove priority from task
+- set_due_date(task_number, due_date) - Set or update due date for a task by intelligently rewriting it (use empty string to remove due date)
+- set_context(task_number, context) - Set or update context for a task by intelligently rewriting it (use empty string to remove context)
+- set_project(task_number, projects) - Set or update projects for a task by intelligently rewriting it (handles array of projects with add/remove operations)
 
 Utility Tools:
 - get_overview() - Show task statistics and summary
 - move_task(task_number, destination, source?) - Move task between files
 - archive_tasks() - Archive completed tasks from todo.txt to done.txt
 - get_calendar(month, year) - Get calendar for specific month and year
+- parse_date(date_expression) - Convert natural language date expressions to YYYY-MM-DD format
 """
 
 import subprocess
@@ -85,34 +89,18 @@ class ToolCallHandler:
                 "function": {
                     "name": "list_tasks",
                     "description": (
-                        "List current tasks with optional filtering. Use this when: "
+                        "List all current tasks from todo.txt. Use this when: "
                         "1) User wants to see their tasks, "
-                        "2) You need to find a specific task by description, "
-                        "3) You need to check for potential duplicates before adding new tasks, "
-                        "4) You need to understand the current state before making changes, "
-                        "5) User says they finished/completed a task and you need to find the matching task. "
+                        "2) You need to check for potential duplicates before adding new tasks, "
+                        "3) You need to understand the current state before making changes, "
+                        "4) User says they finished/completed a task and you need to find the matching task. "
                         "CRITICAL: ALWAYS use this before add_task() to check for similar existing tasks. "
                         "CRITICAL: ALWAYS use this when user mentions task completion to find the correct task number. "
-                        "COMPLETION INTELLIGENCE: When searching for completion matches, if exactly one task clearly "
-                        "matches the user's description, proceed to complete it immediately without asking for confirmation. "
-                        "IMPORTANT: When presenting the results to the user, convert the raw todo.txt format "
-                        "into conversational language. Do not show the raw format like '(A) task +project @context'. "
                         "STRATEGIC CONTEXT: This is the primary discovery tool - call this FIRST when you need to "
-                        "understand existing tasks before making any modifications."
+                        "understand existing tasks before making any modifications. Always get the complete task list "
+                        "for full context rather than trying to filter."
                     ),
-                    "parameters": {
-                        "type": "object",
-                        "properties": {
-                            "filter": {
-                                "type": "string",
-                                "description": (
-                                    "Optional filter string (e.g., '+work', '@office', '(A)') - "
-                                    "use when you want to see only specific tasks or when searching for completion matches"
-                                ),
-                            }
-                        },
-                        "required": [],
-                    },
+                    "parameters": {"type": "object", "properties": {}, "required": []},
                 },
             },
             {
@@ -120,72 +108,17 @@ class ToolCallHandler:
                 "function": {
                     "name": "list_completed_tasks",
                     "description": (
-                        "List completed tasks from done.txt with optional filtering. Use this when: "
+                        "List all completed tasks from done.txt. Use this when: "
                         "1) User tries to complete a task that might already be done, "
                         "2) User asks about completed tasks, "
                         "3) You need to verify task status before taking action, "
-                        "4) User wants to search for specific completed tasks by project, context, text, or date. "
+                        "4) User wants to see their task completion history. "
                         "STRATEGIC CONTEXT: Call this BEFORE complete_task() to verify the task hasn't already "
                         "been completed, preventing duplicate completion attempts. "
-                        "FILTERING: Use the filtering parameters to help users find specific completed tasks "
-                        "when they ask about work tasks, home tasks, tasks from a specific date, etc. "
-                        "DATE FILTERING LIMITATIONS: Due to todo.sh constraints, date filtering has specific behavior: "
-                        "• When both date_from and date_to are provided, filtering uses the year-month pattern (YYYY-MM) "
-                        "from date_from, matching all tasks in that month. "
-                        "• When only date_from is provided, filtering uses the exact date pattern (YYYY-MM-DD). "
-                        "• When only date_to is provided, filtering uses the year-month pattern (YYYY-MM) from date_to. "
-                        "• Complex date ranges (e.g., spanning multiple months) are not supported by todo.sh."
+                        "Always get the complete completed task list for full historical context rather than "
+                        "trying to filter by specific criteria."
                     ),
-                    "parameters": {
-                        "type": "object",
-                        "properties": {
-                            "filter": {
-                                "type": "string",
-                                "description": (
-                                    "Optional raw filter string (e.g., '+work', '@office') - "
-                                    "use for advanced filtering when other parameters aren't sufficient"
-                                ),
-                            },
-                            "project": {
-                                "type": "string",
-                                "description": (
-                                    "Optional project name to filter by (without the + symbol) - "
-                                    "e.g., 'work', 'home', 'bills'"
-                                ),
-                            },
-                            "context": {
-                                "type": "string",
-                                "description": (
-                                    "Optional context name to filter by (without the @ symbol) - "
-                                    "e.g., 'office', 'home', 'phone'"
-                                ),
-                            },
-                            "text_search": {
-                                "type": "string",
-                                "description": (
-                                    "Optional text to search for in task descriptions - "
-                                    "e.g., 'review', 'call', 'email'"
-                                ),
-                            },
-                            "date_from": {
-                                "type": "string",
-                                "description": (
-                                    "Optional start date for filtering (YYYY-MM-DD format) - "
-                                    "e.g., '2025-08-01'. When used alone, matches exact date. "
-                                    "When used with date_to, uses year-month pattern (YYYY-MM) for month-based filtering."
-                                ),
-                            },
-                            "date_to": {
-                                "type": "string",
-                                "description": (
-                                    "Optional end date for filtering (YYYY-MM-DD format) - "
-                                    "e.g., '2025-08-31'. When used alone, uses year-month pattern (YYYY-MM) "
-                                    "for month-based filtering. When used with date_from, uses date_from's year-month pattern."
-                                ),
-                            },
-                        },
-                        "required": [],
-                    },
+                    "parameters": {"type": "object", "properties": {}, "required": []},
                 },
             },
             {
@@ -193,18 +126,21 @@ class ToolCallHandler:
                 "function": {
                     "name": "add_task",
                     "description": (
-                        "Add a new task to todo.txt. CRITICAL: Before adding ANY task, you MUST "
-                        "use list_tasks() and list_completed_tasks() to check for potential duplicates. Look for tasks with "
-                        "similar descriptions, keywords, or intent. If you find similar tasks, "
+                        "Add a NEW task to todo.txt with intelligent automatic inference capabilities. "
+                        "USE CASE: Call this when user wants to create a NEW task, not when they want to complete, modify, or work with existing tasks. "
+                        "CRITICAL: Before adding ANY task, you MUST use list_tasks() and list_completed_tasks() to check for potential duplicates. "
+                        "Look for tasks with similar descriptions, keywords, or intent. If you find similar tasks, "
                         "ask the user if they want to add a new task or modify an existing one. "
-                        "AUTOMATIC INFERENCE: When project, context, or due date is not specified, automatically infer appropriate tags "
-                        "and due dates based on the task content, natural language expressions, task nature, calendar context, and existing patterns. "
-                        "DUE DATE INFERENCE: Use parse_date() tool to convert any temporal expressions to YYYY-MM-DD format. "
-                        "Extract temporal expressions and use common sense to infer appropriate due dates based on task type, "
-                        "work patterns, personal schedules, and existing task due date patterns. Only ask for clarification when genuinely ambiguous. "
-                        "Always provide a complete, natural response to the user. "
-                        "STRATEGIC CONTEXT: This is a modification tool - call this LAST after using "
-                        "discovery tools (list_tasks, list_projects, list_contexts list_completed_tasks) "
+                        "INTELLIGENT INFERENCE ENGINE: This tool automatically infers missing elements to create complete, actionable tasks: "
+                        "PROJECT INFERENCE: Automatically detect and add appropriate +project tags based on task keywords, semantic patterns, and existing project usage. "
+                        "CONTEXT INFERENCE: Automatically infer @context tags from task nature, location requirements, and historical context patterns. "
+                        "DUE DATE INFERENCE: Use parse_date() tool to convert natural language expressions ('tomorrow', 'next week', 'by Friday') to YYYY-MM-DD format. "
+                        "Apply strategic timing based on task type, work patterns, personal schedules, and existing due date patterns. "
+                        "DURATION INFERENCE: Automatically estimate appropriate duration: tags based on task complexity, context, and historical patterns. "
+                        "PRIORITY INFERENCE: Suggest appropriate priority levels (A-Z) based on urgency, importance, and existing priority patterns. "
+                        "Only ask for clarification when genuinely ambiguous. Always provide a complete, natural response to the user. "
+                        "STRATEGIC CONTEXT: This is a CREATION tool - call this LAST after using "
+                        "discovery tools (list_tasks, list_projects, list_contexts, list_completed_tasks) "
                         "to gather all necessary context and verify no duplicates exist."
                     ),
                     "parameters": {
@@ -234,6 +170,10 @@ class ToolCallHandler:
                                 "type": "string",
                                 "description": "Optional recurring pattern in rec:frequency[:interval] format (e.g., 'rec:daily', 'rec:weekly:2', 'rec:monthly'). Use for tasks that repeat automatically.",
                             },
+                            "duration": {
+                                "type": "string",
+                                "description": "Optional duration estimate in format: minutes (e.g., '30m'), hours (e.g., '2h'), or days (e.g., '1d'). Use for time planning and task prioritization.",
+                            },
                         },
                         "required": ["description"],
                     },
@@ -244,14 +184,11 @@ class ToolCallHandler:
                 "function": {
                     "name": "complete_task",
                     "description": (
-                        "Mark a specific task as complete by its line number. IMPORTANT: "
-                        "When user says they finished/completed a task, FIRST use list_tasks() to find matching tasks, "
-                        "then list_completed_tasks() to verify it's not already done. "
-                        "COMPLETION LOGIC: If user's statement clearly matches exactly one task, complete it immediately. "
-                        "If multiple tasks match, show numbered options and ask for clarification. "
-                        "If the match is ambiguous, ask for confirmation. "
-                        "STRATEGIC CONTEXT: This is a modification tool - call this LAST after using "
-                        "discovery tools (list_tasks, list_completed_tasks) to verify the task exists and status."
+                        "Mark an existing task as complete by its line number. "
+                        "USE CASE: Only call this when user explicitly states they have finished/completed a task. "
+                        "WORKFLOW: 1) Use list_tasks() to find the task to complete, 2) Use list_completed_tasks() to verify it's not already done, 3) Call complete_task() with the task number. "
+                        "NOT FOR: Adding new tasks, modifying task content, or any other task operations. "
+                        "This tool ONLY marks existing tasks as complete."
                     ),
                     "parameters": {
                         "type": "object",
@@ -270,8 +207,10 @@ class ToolCallHandler:
                 "function": {
                     "name": "replace_task",
                     "description": (
-                        "Replace the entire content of a task. IMPORTANT: Use list_tasks() first "
-                        "to find the correct task number if user doesn't specify it. "
+                        "Replace the entire content of an EXISTING task. "
+                        "USE CASE: Call this when user wants to completely rewrite an existing task description. "
+                        "NOT FOR: Creating new tasks, completing tasks, or adding to tasks. "
+                        "Use list_tasks() first to find the correct task number if user doesn't specify it. "
                         "If multiple tasks match the description, ask for clarification."
                     ),
                     "parameters": {
@@ -295,8 +234,13 @@ class ToolCallHandler:
                 "function": {
                     "name": "append_to_task",
                     "description": (
-                        "Add text to the end of an existing task. Use this when user wants "
-                        "to add additional information to a task without replacing it entirely."
+                        "Add text to the end of an EXISTING task. "
+                        "USE CASE: Call this when user wants to add additional descriptive text, notes, or comments to an existing task. "
+                        "NOT FOR: Creating new tasks, completing tasks, or adding project/context/due date tags. "
+                        "CRITICAL: DO NOT use this for adding project tags (+project) or context tags (@context) - "
+                        "use set_project() or set_context() instead. "
+                        "DO NOT use this for adding due dates - use set_due_date() instead. "
+                        "This tool is ONLY for adding descriptive text, notes, or comments to existing tasks."
                     ),
                     "parameters": {
                         "type": "object",
@@ -319,8 +263,10 @@ class ToolCallHandler:
                 "function": {
                     "name": "prepend_to_task",
                     "description": (
-                        "Add text to the beginning of an existing task. Use this when user "
-                        "wants to add a prefix or modifier to a task."
+                        "Add text to the beginning of an EXISTING task. "
+                        "USE CASE: Call this when user wants to add a prefix or modifier to an existing task. "
+                        "NOT FOR: Creating new tasks, completing tasks, or adding project/context/due date tags. "
+                        "This tool is ONLY for modifying existing tasks by adding text at the beginning."
                     ),
                     "parameters": {
                         "type": "object",
@@ -343,7 +289,9 @@ class ToolCallHandler:
                 "function": {
                     "name": "delete_task",
                     "description": (
-                        "Delete an entire task or remove a specific term from a task. "
+                        "Delete an entire EXISTING task or remove a specific term from an EXISTING task. "
+                        "USE CASE: Call this when user wants to delete a task completely or remove specific text from an existing task. "
+                        "NOT FOR: Creating new tasks, completing tasks, or any other task operations. "
                         "IMPORTANT: Use list_tasks() first to find the correct task number "
                         "if user doesn't specify it."
                     ),
@@ -371,7 +319,9 @@ class ToolCallHandler:
                 "function": {
                     "name": "set_priority",
                     "description": (
-                        "Set or change the priority of a task (A-Z, where A is highest). "
+                        "Set or change the priority of an EXISTING task (A-Z, where A is highest). "
+                        "USE CASE: Call this when user wants to add, change, or remove priority on an existing task. "
+                        "NOT FOR: Creating new tasks, completing tasks, or any other task operations. "
                         "IMPORTANT: Use list_tasks() first to find the correct task number "
                         "if user doesn't specify it."
                     ),
@@ -396,7 +346,10 @@ class ToolCallHandler:
                 "function": {
                     "name": "remove_priority",
                     "description": (
-                        "Remove the priority from a task. IMPORTANT: Use list_tasks() first "
+                        "Remove the priority from an EXISTING task. "
+                        "USE CASE: Call this when user wants to remove priority from an existing task. "
+                        "NOT FOR: Creating new tasks, completing tasks, or any other task operations. "
+                        "IMPORTANT: Use list_tasks() first "
                         "to find the correct task number if user doesn't specify it."
                     ),
                     "parameters": {
@@ -411,6 +364,103 @@ class ToolCallHandler:
                     },
                 },
             },
+            {
+                "type": "function",
+                "function": {
+                    "name": "set_due_date",
+                    "description": (
+                        "Set or update the due date for an EXISTING task by intelligently rewriting it. "
+                        "USE CASE: Call this when user wants to add, change, or remove a due date on an existing task. "
+                        "NOT FOR: Creating new tasks, completing tasks, or any other task operations. "
+                        "This preserves all existing task components (priority, projects, contexts, etc.) "
+                        "while updating or adding the due date. Use empty string to remove the due date. "
+                        "IMPORTANT: Use list_tasks() first "
+                        "to find the correct task number if user doesn't specify it. "
+                        "Use parse_date() tool to convert natural language expressions like 'tomorrow', "
+                        "'next week', 'by Friday' to YYYY-MM-DD format."
+                    ),
+                    "parameters": {
+                        "type": "object",
+                        "properties": {
+                            "task_number": {
+                                "type": "integer",
+                                "description": "The line number of the task to modify (required)",
+                            },
+                            "due_date": {
+                                "type": "string",
+                                "description": "Due date in YYYY-MM-DD format, or empty string to remove due date (required). Use parse_date() tool to convert natural language expressions.",
+                            },
+                        },
+                        "required": ["task_number", "due_date"],
+                    },
+                },
+            },
+            {
+                "type": "function",
+                "function": {
+                    "name": "set_context",
+                    "description": (
+                        "Set or update the context for an EXISTING task by intelligently rewriting it. "
+                        "USE CASE: Call this when user wants to add, change, or remove a context tag on an existing task. "
+                        "NOT FOR: Creating new tasks, completing tasks, or any other task operations. "
+                        "This preserves all existing task components (priority, projects, due date, etc.) "
+                        "while updating or adding the context. Use empty string to remove the context. "
+                        "PREFERRED METHOD: Use this instead of append_to_task() when adding context tags (@context). "
+                        "This tool properly manages context organization and prevents formatting issues. "
+                        "IMPORTANT: Use list_tasks() first "
+                        "to find the correct task number if user doesn't specify it."
+                    ),
+                    "parameters": {
+                        "type": "object",
+                        "properties": {
+                            "task_number": {
+                                "type": "integer",
+                                "description": "The line number of the task to modify (required)",
+                            },
+                            "context": {
+                                "type": "string",
+                                "description": "Context to set for the task (required). Use empty string to remove context.",
+                            },
+                        },
+                        "required": ["task_number", "context"],
+                    },
+                },
+            },
+            {
+                "type": "function",
+                "function": {
+                    "name": "set_project",
+                    "description": (
+                        "Set or update projects for an EXISTING task by intelligently rewriting it. "
+                        "USE CASE: Call this when user wants to add, change, or remove project tags on an existing task. "
+                        "NOT FOR: Creating new tasks, completing tasks, or any other task operations. "
+                        "This preserves all existing task components and manages projects intelligently. "
+                        "Supports multiple projects, prevents duplicates, and groups them together. "
+                        "Empty array or empty strings are NOOPs (no changes). "
+                        "Use '-project' syntax to remove specific projects. "
+                        "PREFERRED METHOD: Use this instead of append_to_task() when adding project tags (+project). "
+                        "This tool properly manages project organization and prevents formatting issues. "
+                        "IMPORTANT: Use list_tasks() first "
+                        "to find the correct task number if user doesn't specify it. "
+                        "Project names should be provided without the + symbol (e.g., 'work' not '+work')."
+                    ),
+                    "parameters": {
+                        "type": "object",
+                        "properties": {
+                            "task_number": {
+                                "type": "integer",
+                                "description": "The line number of the task to modify (required)",
+                            },
+                            "projects": {
+                                "type": "array",
+                                "items": {"type": "string"},
+                                "description": "Array of project operations. Each item can be: project name (add), '-project' (remove), or empty string (remove all) (required).",
+                            },
+                        },
+                        "required": ["task_number", "projects"],
+                    },
+                },
+            },
             {
                 "type": "function",
                 "function": {
@@ -427,7 +477,9 @@ class ToolCallHandler:
                 "function": {
                     "name": "move_task",
                     "description": (
-                        "Move a task from one file to another (e.g., from todo.txt to done.txt). "
+                        "Move an EXISTING task from one file to another (e.g., from todo.txt to done.txt). "
+                        "USE CASE: Call this when user wants to move a task between different todo files. "
+                        "NOT FOR: Creating new tasks, completing tasks, or any other task operations. "
                         "IMPORTANT: Use list_tasks() first to find the correct task number "
                         "if user doesn't specify it."
                     ),
@@ -724,10 +776,12 @@ class ToolCallHandler:
             "delete_task": self.todo_manager.delete_task,
             "set_priority": self.todo_manager.set_priority,
             "remove_priority": self.todo_manager.remove_priority,
+            "set_due_date": self.todo_manager.set_due_date,
+            "set_context": self.todo_manager.set_context,
+            "set_project": self.todo_manager.set_project,
             "get_overview": self.todo_manager.get_overview,
             "move_task": self.todo_manager.move_task,
             "archive_tasks": self.todo_manager.archive_tasks,
-            "deduplicate_tasks": self.todo_manager.deduplicate_tasks,
             "parse_date": self._parse_date,
             "get_calendar": self._get_calendar,
         }

{todo_agent-0.2.8.dist-info → todo_agent-0.3.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: todo-agent
-Version: 0.2.8
+Version: 0.3.1
 Summary: A natural language interface for todo.sh task management
 Author: codeprimate
 Maintainer: codeprimate
@@ -51,7 +51,7 @@ A natural language interface for [todo.sh](https://github.com/todotxt/todo.txt-c
 
 ## What it does
 
-Transform natural language into todo.sh commands:
+Transform natural language into todo.sh commands with intelligent task management:
 
 ```bash
 # Use interactively
@@ -62,91 +62,43 @@ todo-agent "add buy groceries to shopping list"
 todo-agent "show my work tasks"
 ```
 
-## Quick Start
-
-### 1. Install
+## Why Todo Agent?
 
-#### Prerequisites
+**Speak naturally** instead of memorizing commands. Todo Agent understands "add dentist appointment next Monday" and automatically sets the right date, project, and context.
 
-**Install todo.sh (required)**
+**Get intelligent insights** beyond basic task lists. It organizes tasks strategically, suggests priorities, and recommends optimal timing based on your patterns.
 
-todo.sh is the underlying task management system that todo-agent interfaces with.
+**Work smarter** with automatic duplicate detection, recurring task handling, and calendar-aware scheduling.
 
-**macOS:**
-```bash
-# Using Homebrew
-brew install todo-txt
-# Or using MacPorts
-sudo port install todo-txt
-```
+**Choose your privacy** - use cloud AI (OpenRouter) or run locally (Ollama).
 
-**Linux:**
-```bash
-# Ubuntu/Debian
-sudo apt-get install todo-txt-cli
-# CentOS/RHEL/Fedora
-sudo yum install todo-txt-cli
-# or
-sudo dnf install todo-txt-cli
-# Arch Linux
-sudo pacman -S todo-txt-cli
-```
+## Quick Start
 
-**Windows:**
-```bash
-# Using Chocolatey
-choco install todo-txt-cli
-# Using Scoop
-scoop install todo-txt-cli
-```
+### 1. Install
 
-**From source:**
-```bash
-git clone https://github.com/todotxt/todo.txt-cli.git
-cd todo.txt-cli
-make
-sudo make install
-```
+#### Install todo.sh (required)
 
-#### Configure todo.sh
+**macOS:** `brew install todo-txt`  
+**Linux:** `sudo apt-get install todo-txt-cli` (Ubuntu/Debian) or `sudo pacman -S todo-txt-cli` (Arch)  
+**Windows:** `choco install todo-txt-cli` (Chocolatey) or `scoop install todo-txt-cli` (Scoop)
 
-After installing todo.sh, you need to set up your todo.txt repository:
+#### Set up todo.sh
 
 ```bash
-# Create a directory for your todo files
-mkdir ~/todo
-cd ~/todo
-
-# Initialize todo.sh (this creates the initial todo.txt file)
+# Create and initialize your todo directory
+mkdir ~/todo && cd ~/todo
 todo.sh init
 
-# Verify installation
-todo.sh version
-```
-
-**Important:** Set the `TODO_DIR` environment variable to point to your todo.txt repository:
-
-```bash
+# Add to your shell profile (.bashrc, .zshrc, etc.)
 export TODO_DIR="$HOME/todo"
 ```
 
-You can add this to your shell profile (`.bashrc`, `.zshrc`, etc.) to make it permanent.
-
 #### Install todo-agent
 
 ```bash
-# Clone and install from source
 git clone https://github.com/codeprimate/todo-agent.git
 cd todo_agent
-
-# Option 1: Install built package locally
 make install
-
-# Option 2: Install in development mode with dev dependencies
-make install-dev
-
-# Option 3: Install in development mode (basic)
-pip install -e .
 ```
 
 ### 2. Set up your LLM provider
@@ -200,6 +152,22 @@ todo-agent "show completed tasks"
 todo-agent "list my contexts"
 ```
 
+### Strategic Planning
+```bash
+todo-agent "what should I do next?"
+todo-agent "organize my tasks by priority"
+todo-agent "show me everything due this week"
+todo-agent "what tasks are blocking other work?"
+```
+
+### Natural Language Intelligence
+```bash
+todo-agent "add dentist appointment next Monday"
+todo-agent "set up recurring daily vitamin reminder"
+todo-agent "move all completed tasks to archive"
+todo-agent "show me tasks I can do from home"
+```
+
 ## Configuration
 
 

{todo_agent-0.2.8.dist-info → todo_agent-0.3.1.dist-info}/RECORD

@@ -1,29 +1,29 @@
 todo_agent/__init__.py,sha256=RUowhd14r3tqB_7rl83unGV8oBjra3UOIl7jix-33fk,254
-todo_agent/_version.py,sha256=NCr4lkV1m1Jmisv_F-sazmV2gGdDIaVwqLyPwmjayqM,704
+todo_agent/_version.py,sha256=gGLpQUQx-ty9SEy9PYw9OgJWWzJLBnCpfJOfzL7SjlI,704
 todo_agent/main.py,sha256=-ryhMm4c4sz4e4anXI8B-CYnpEh5HIkmnYcnGxcWHDk,1628
 todo_agent/core/__init__.py,sha256=QAZ4it63pXv5-DxtNcuSAmg7ZnCY5ackI5yycvKHr9I,365
 todo_agent/core/conversation_manager.py,sha256=nRFcDMqZtumVipggzVe94Hwz9HDbc2CrTssk_HImwEI,13548
 todo_agent/core/exceptions.py,sha256=cPvvkIbKdI7l51wC7cE-ZxUi54P3nf2m7x2lMNMRFYM,399
-todo_agent/core/todo_manager.py,sha256=ZiCXfgS4kor3tdojwEKwD2G1lX-W9XuaoYvER82PHNM,10438
+todo_agent/core/todo_manager.py,sha256=wOgwXZCS5xZw7lHDnIar0L8r1pvgdUguu6kmFF9xSi8,16282
 todo_agent/infrastructure/__init__.py,sha256=SGbHXgzq6U1DMgOfWPMsWEK99zjPSF-6gzy7xqc5fsI,284
 todo_agent/infrastructure/calendar_utils.py,sha256=HmF0ykXF_6GbdoJvZLIv6fKwT6ipixoywdTMkIXmkGU,1871
 todo_agent/infrastructure/config.py,sha256=zyp6qOlg1nN_awphivlgGNBE6fL0Hf66YgvWxR8ldyQ,2117
-todo_agent/infrastructure/inference.py,sha256=PJouydXREgTIkZQVumdCvrwIbMdPR79baRV1W0s2TLA,11802
+todo_agent/infrastructure/inference.py,sha256=T_xwSd2oB5CsPKExJoQ_RahpMB4U0PKIOUMR0vQyE5I,11883
 todo_agent/infrastructure/llm_client.py,sha256=ZoObyqaRP6i_eqGYGfJWGeWTJ-VNxpY70ay04vt2v_E,1390
 todo_agent/infrastructure/llm_client_factory.py,sha256=-tktnVOIF7B45WR7AuLoi7MKnEyuM8lgg1jjc4T1FhM,1929
 todo_agent/infrastructure/logger.py,sha256=2ykG_0lyzmEGxDF6ZRl1qiTUGDuFeQgzv4Na6vRmXcM,4110
 todo_agent/infrastructure/ollama_client.py,sha256=RVgHqX37k7q5xEaEXdhcCv2HYQiszs1QV39RxFFMIas,5902
-todo_agent/infrastructure/openrouter_client.py,sha256=7qusHuOH-zMKMrQw98v3MKwSWUJwL0mZsdShSjeoti0,7121
-todo_agent/infrastructure/todo_shell.py,sha256=z6kqUKDX-i4DfYJKoOLiPLCp8y6m1HdTDLHTvmLpzMc,5801
+todo_agent/infrastructure/openrouter_client.py,sha256=2Ysf69z265dgkgDMLJR92v26-32DkuSAqKSN-ZCEX_Y,6948
+todo_agent/infrastructure/todo_shell.py,sha256=0-GT_ReYMPCujy1KrB5PEQ98fbIZJm9-sVre5iCkFYE,17633
 todo_agent/infrastructure/token_counter.py,sha256=PCKheOVJbp1s89yhh_i6iKgURMt9mVoYkwjQJCc2xCE,4958
-todo_agent/infrastructure/prompts/system_prompt.txt,sha256=j7N8GhMbyRR7QqfkokbCJiElv6CdAhc22PVzY6vrucE,15880
+todo_agent/infrastructure/prompts/system_prompt.txt,sha256=sin8wOFrDntTgKL1udlwE3iNxf_Pk1H1ZGzxGon23Wc,18931
 todo_agent/interface/__init__.py,sha256=vDD3rQu4qDkpvVwGVtkDzE1M4IiSHYzTif4GbYSFWaI,457
-todo_agent/interface/cli.py,sha256=C746b83dQTiyUfthcC-pngwsJlmXZAu10_hxsSOMzdM,12022
+todo_agent/interface/cli.py,sha256=rSHJjSlKEV8dirCcMT1zX55i8raMOE_3IB6CUFGLgiI,12094
 todo_agent/interface/formatters.py,sha256=DiQLemndiuFWjLcBRPpu1wVnJcoYAFP8t_fJstOgaDs,18918
-todo_agent/interface/tools.py,sha256=_GlZwX09dYpqPB2Q-EsgGguA1PVl8_mRCdks6ucaJgU,39686
-todo_agent-0.2.8.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
-todo_agent-0.2.8.dist-info/METADATA,sha256=ynVrlFUs89Qfgp6R3YnbvZGykjHD4CjNnJaLNm-oz1w,10047
-todo_agent-0.2.8.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-todo_agent-0.2.8.dist-info/entry_points.txt,sha256=4W7LrCib6AXP5IZDwWRht8S5gutLu5oNfTJHGbt4oHs,52
-todo_agent-0.2.8.dist-info/top_level.txt,sha256=a65mlPIhPZHuq2bRIi_sCMAIJsUddvXt171OBF6r6co,11
-todo_agent-0.2.8.dist-info/RECORD,,
+todo_agent/interface/tools.py,sha256=nPO4Sx-JlRUv0-JTzg6caSdDr7tGLGagMvEqblnDJfU,44364
+todo_agent-0.3.1.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+todo_agent-0.3.1.dist-info/METADATA,sha256=HXdjiFn4ELWARfPjhQjpLY8lx2tiHezZ7ylkvQ8EXsI,10134
+todo_agent-0.3.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+todo_agent-0.3.1.dist-info/entry_points.txt,sha256=4W7LrCib6AXP5IZDwWRht8S5gutLu5oNfTJHGbt4oHs,52
+todo_agent-0.3.1.dist-info/top_level.txt,sha256=a65mlPIhPZHuq2bRIi_sCMAIJsUddvXt171OBF6r6co,11
+todo_agent-0.3.1.dist-info/RECORD,,