todo-agent 0.1.0__py3-none-any.whl

todo_agent-0.1.0.dist-info/METADATA

@@ -0,0 +1,282 @@
+Metadata-Version: 2.4
+Name: todo-agent
+Version: 0.1.0
+Summary: A natural language interface for todo.sh task management
+Author: codeprimate
+Maintainer: codeprimate
+License-Expression: GPL-3.0
+Project-URL: Homepage, https://github.com/codeprimate/todo_agent
+Project-URL: Documentation, https://github.com/codeprimate/todo_agent#readme
+Project-URL: Repository, https://github.com/codeprimate/todo_agent
+Project-URL: Bug Tracker, https://github.com/codeprimate/todo_agent/issues
+Keywords: todo,task-management,llm,natural-language,cli
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: End Users/Desktop
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Scheduling
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Text Processing :: Linguistic
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: requests>=2.31.0
+Requires-Dist: typing-extensions>=4.8.0
+Requires-Dist: types-requests>=2.31.0
+Requires-Dist: rich>=13.0.0
+Requires-Dist: tiktoken>=0.5.0
+Provides-Extra: dev
+Requires-Dist: black>=23.0.0; extra == "dev"
+Requires-Dist: flake8>=6.0.0; extra == "dev"
+Requires-Dist: isort>=5.12.0; extra == "dev"
+Requires-Dist: mypy>=1.0.0; extra == "dev"
+Requires-Dist: pytest>=7.0.0; extra == "dev"
+Requires-Dist: pytest-cov>=4.0.0; extra == "dev"
+Requires-Dist: pre-commit>=3.0.0; extra == "dev"
+Requires-Dist: bandit>=1.7.0; extra == "dev"
+Requires-Dist: safety>=2.3.0; extra == "dev"
+Requires-Dist: sphinx>=6.0.0; extra == "dev"
+Requires-Dist: sphinx-rtd-theme>=1.2.0; extra == "dev"
+Requires-Dist: radon>=5.1.0; extra == "dev"
+Requires-Dist: xenon>=0.7.0; extra == "dev"
+Requires-Dist: build>=1.0.0; extra == "dev"
+Requires-Dist: twine>=4.0.0; extra == "dev"
+Requires-Dist: setuptools_scm[toml]>=6.2.0; extra == "dev"
+Dynamic: license-file
+
+# Todo Agent
+
+A natural language interface for [todo.sh](https://github.com/todotxt/todo.txt-cli) task management powered by LLM function calling.
+
+## What it does
+
+Transform natural language into todo.sh commands:
+
+```bash
+# Use interactively
+todo-agent
+# Instead of: todo.sh add "Buy groceries +shopping"
+todo-agent "add buy groceries to shopping list"
+# Instead of: todo.sh list +work
+todo-agent "show my work tasks"
+```
+
+## Quick Start
+
+### 1. Install
+
+#### Prerequisites
+
+**Install todo.sh (required)**
+
+todo.sh is the underlying task management system that todo-agent interfaces with.
+
+**macOS:**
+```bash
+# Using Homebrew
+brew install todo-txt
+# Or using MacPorts
+sudo port install todo-txt
+```
+
+**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
+```
+
+**Windows:**
+```bash
+# Using Chocolatey
+choco install todo-txt-cli
+# Using Scoop
+scoop install todo-txt-cli
+```
+
+**From source:**
+```bash
+git clone https://github.com/todotxt/todo.txt-cli.git
+cd todo.txt-cli
+make
+sudo make install
+```
+
+#### Configure todo.sh
+
+After installing todo.sh, you need to set up your todo.txt repository:
+
+```bash
+# Create a directory for your todo files
+mkdir ~/todo
+cd ~/todo
+
+# Initialize todo.sh (this creates the initial todo.txt file)
+todo.sh init
+
+# Verify installation
+todo.sh version
+```
+
+**Important:** Set the `TODO_DIR` environment variable to point to your todo.txt repository:
+
+```bash
+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
+pip install -e .
+
+# Or with development dependencies
+pip install -e ".[dev]"
+```
+
+### 2. Set up your LLM provider
+
+**Option A: OpenRouter (recommended)**
+```bash
+export OPENROUTER_API_KEY="your-api-key-here"
+```
+
+**Option B: Ollama (local)**
+```bash
+# Install and start Ollama
+ollama pull mistral-small3.1
+
+# Configure environment
+export LLM_PROVIDER=ollama
+export OLLAMA_MODEL=mistral-small3.1
+```
+
+### 3. Use it
+
+```bash
+# Interactive mode
+todo-agent
+
+# Single command
+todo-agent "add urgent meeting with team +work @office"
+```
+
+## Examples
+
+### Task Management
+```bash
+todo-agent "add buy groceries to shopping list"
+todo-agent "list my work tasks"
+todo-agent "complete the shopping task"
+todo-agent "delete task 5"
+```
+
+### Task Modification
+```bash
+todo-agent "change task 2 to buy organic milk"
+todo-agent "add urgent to task 1"
+todo-agent "set task 3 as high priority"
+```
+
+### Discovery
+```bash
+todo-agent "what projects do I have?"
+todo-agent "show completed tasks"
+todo-agent "list my contexts"
+```
+
+## Configuration
+
+
+### Configuration Variables
+
+| Variable              | Description                               | Default                | Required                      |
+|-----------------------|-------------------------------------------|------------------------|-------------------------------|
+| `LLM_PROVIDER`        | LLM provider: `openrouter` or `ollama`    | `openrouter`           | No (defaults to `openrouter`) |
+| `TODO_DIR`            | Path to your todo.txt repository          | —                      | **Yes**                       |
+| `OPENROUTER_API_KEY`  | Your OpenRouter API key                   | —                      | Yes (if using OpenRouter)     |
+| `OLLAMA_MODEL`        | Model name for Ollama                     | `mistral-small3.1`     | No                            |
+| `LOG_LEVEL`           | Logging verbosity (`INFO`, `DEBUG`, etc.) | `INFO`                 | No                            |
+
+**Note:**  
+- `TODO_DIR` is required for all configurations.  
+- `OPENROUTER_API_KEY` is only required if you use the OpenRouter provider.  
+- The `TODO_FILE`, `DONE_FILE`, and `REPORT_FILE` are automatically inferred from `TODO_DIR`.
+
+The `TODO_FILE`, `DONE_FILE`, and `REPORT_FILE` are automatically inferred from `TODO_DIR`.
+
+## Development
+
+```bash
+# Clone and install
+git clone https://github.com/codeprimate/todo-agent.git
+cd todo_agent
+pip install -e ".[dev]"
+
+# Run tests
+pytest
+
+# Format code
+black .
+isort .
+```
+
+## Architecture
+
+The todo-agent follows a clean, layered architecture with clear separation of concerns:
+
+### **Interface Layer** (`todo_agent/interface/`)
+- **CLI**: User interaction, input/output handling, and application loop
+- **Tools**: Function schemas and execution logic for LLM function calling
+- **Formatters**: Output formatting and presentation
+
+### **Core Layer** (`todo_agent/core/`)
+- **TodoManager**: Business logic orchestrator that translates high-level operations into todo.sh commands
+- **ConversationManager**: Manages conversation state, memory, and context for multi-turn interactions
+- **TaskParser**: Parses and validates task-related operations
+- **Exceptions**: Custom exception classes for error handling
+
+### **Infrastructure Layer** (`todo_agent/infrastructure/`)
+- **Inference Engine**: Orchestrates LLM interactions, tool calling, and conversation flow
+- **LLM Clients**: Provider-specific implementations (OpenRouter, Ollama) with factory pattern
+- **TodoShell**: Subprocess wrapper for executing todo.sh commands
+- **Configuration**: Environment and settings management
+- **Logging**: Structured logging throughout the application
+- **Token Counter**: Manages conversation token limits and costs
+
+### **How It Works**
+
+1. **User Input** → Natural language request (e.g., "add buy groceries to shopping list")
+2. **CLI** → Captures input and passes to inference engine
+3. **Inference Engine** → Sends request to LLM with available tools
+4. **LLM** → Analyzes request and decides which tools to call
+5. **Tool Execution** → TodoManager → TodoShell → todo.sh
+6. **Response** → Results returned through conversation manager to user
+
+### **Key Features**
+- **Function Calling**: LLM intelligently selects and executes appropriate tools
+- **Conversation Memory**: Maintains context across interactions
+- **Multi-Provider Support**: Works with cloud (OpenRouter) and local (Ollama) LLMs
+- **Error Handling**: Robust error management with detailed logging
+- **Performance Monitoring**: Tracks thinking time and conversation metrics
+
+## License
+
+GNU General Public License v3.0
+
+This project is licensed under the GNU General Public License v3.0 - see the [LICENSE](LICENSE) file for details.

todo_agent-0.1.0.dist-info/RECORD

@@ -0,0 +1,27 @@
+todo_agent/__init__.py,sha256=RUowhd14r3tqB_7rl83unGV8oBjra3UOIl7jix-33fk,254
+todo_agent/_version.py,sha256=5jwwVncvCiTnhOedfkzzxmxsggwmTBORdFL_4wq0ZeY,704
+todo_agent/main.py,sha256=YUcCf6oYSnmbT4KfRK6uKzdPxbjLYtSdrRCWxRjTzAI,1247
+todo_agent/core/__init__.py,sha256=YM7c1CqWzlQlHerlxgLPsW0fABO3tpeV4NIUKma9bNc,365
+todo_agent/core/conversation_manager.py,sha256=dyNml0D6Lk8SDKSbd6GIC2SjUOlsAooRmMIMfNRlhzc,10896
+todo_agent/core/exceptions.py,sha256=cPvvkIbKdI7l51wC7cE-ZxUi54P3nf2m7x2lMNMRFYM,399
+todo_agent/core/todo_manager.py,sha256=puq2QWvZ4jblRoWfSmy2Zk-O-nXJVATJwa1cCFppjms,7960
+todo_agent/infrastructure/__init__.py,sha256=XeMvJ-ZvVz2pZmZthZrC4Qlk8VxwLHyIpqr3btUIHLE,284
+todo_agent/infrastructure/config.py,sha256=XYp3CJP51vJYA3vM_Dq5BLYn02vNuFE31qC45Zjml5I,2095
+todo_agent/infrastructure/inference.py,sha256=7TJKpIaBlOQ1NbBB3LOt2M9aO613jbr6aJNmmIUyNuo,9568
+todo_agent/infrastructure/llm_client.py,sha256=ZoObyqaRP6i_eqGYGfJWGeWTJ-VNxpY70ay04vt2v_E,1390
+todo_agent/infrastructure/llm_client_factory.py,sha256=-FD6gBflLB0zqpNASTSmr8Yxl5bHaxCOLlMWAcck60U,1715
+todo_agent/infrastructure/logger.py,sha256=JF3G1Yq6lB6YIgaXnxjCWy4zbP7TPEIdvDIpwRApn34,4247
+todo_agent/infrastructure/ollama_client.py,sha256=VgXPInI5KH6P1Ub9WYJyfYgKkVWbEuJxE_Bts-dke6o,5358
+todo_agent/infrastructure/openrouter_client.py,sha256=AzUSKWF3_9RfhSMzCn82tW2fu6W1uFe0NzgfInwnn0o,6601
+todo_agent/infrastructure/todo_shell.py,sha256=7CF6WnB2W4_v95kjr-DxrRQUDHfuCvUQtJ0NrhDGUow,5738
+todo_agent/infrastructure/token_counter.py,sha256=NC9-y4v7kJRFRlAYe1a7tW-pfFtE4qQslUpVxR-yssM,5121
+todo_agent/infrastructure/prompts/system_prompt.txt,sha256=uCb6yz3uDQdwcB8HJcF0y1_1b75oRtRnCMMHQLHI3NI,2415
+todo_agent/interface/__init__.py,sha256=7nnDEP7w2qYMQJPPzlojCOoYebqw6SmAqJ886CdwXT4,204
+todo_agent/interface/cli.py,sha256=2c7Pq6-_5URTbvN98_eWKf68m8gwXr6_TJ-XxtxikLc,8429
+todo_agent/interface/tools.py,sha256=QZce0HHk5BYmUrGTBLse49tg2C6o5p3pkbd2c99x4MQ,28500
+todo_agent-0.1.0.dist-info/licenses/LICENSE,sha256=OXLcl0T2SZ8Pmy2_dmlvKuetivmyPd5m1q-Gyd-zaYY,35149
+todo_agent-0.1.0.dist-info/METADATA,sha256=OI38wernGqhAEOhurFDKQGN7839gKqnw_n29NOoWkVY,8735
+todo_agent-0.1.0.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+todo_agent-0.1.0.dist-info/entry_points.txt,sha256=4W7LrCib6AXP5IZDwWRht8S5gutLu5oNfTJHGbt4oHs,52
+todo_agent-0.1.0.dist-info/top_level.txt,sha256=a65mlPIhPZHuq2bRIi_sCMAIJsUddvXt171OBF6r6co,11
+todo_agent-0.1.0.dist-info/RECORD,,

todo_agent-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (80.9.0)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

todo_agent-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,2 @@
+[console_scripts]
+todo-agent = todo_agent.main:main