Fix Windows CLI entry point import error (ModuleNotFoundError: No module named 'cli')

README.md

@@ -89,6 +89,11 @@ treeagent "hello world"           # prints skeleton task tree
 treeagent --model-type openai "hello"  # use OpenAI accessor by default
 ```
 
+> **Note**: If you encounter import issues with the `treeagent` command on Windows, you can alternatively use:
+> ```bash
+> python -m src.treeagent "hello world"
+> ```
+
 > Heads-up: you’ll need an OpenAI (or other) API key in your shell once the first agent stubs call an LLM.
 
 

cli.py

@@ -0,0 +1,21 @@
+"""CLI entry point compatibility module.
+
+This module provides compatibility for Windows installations where
+entry points might resolve differently. It imports and re-exports
+the main function from the actual CLI module.
+
+This addresses the issue where Windows pip installations generate entry scripts
+that import 'cli' instead of 'src.cli', causing ModuleNotFoundError.
+"""
+
+try:
+    # Try to import from the src package structure (development/editable install)
+    from src.cli import main
+except ImportError:
+    # Fallback for potential different package structures
+    try:
+        from .cli import main
+    except ImportError:
+        raise ImportError("Could not import CLI main function from either src.cli or .cli")
+
+__all__ = ['main']

src/treeagent/__main__.py

@@ -0,0 +1,7 @@
+#!/usr/bin/env python3
+"""Main entry point for TreeAgent CLI when run as module (python -m treeagent)."""
+
+from src.cli import main
+
+if __name__ == "__main__":
+    main()