fixed agentstack commands to use uv when available

Author: ranvier2d2

README.md

@@ -120,10 +120,14 @@ agentstack tools add
 
 ## Running Your Agent
 
-`agentstack run`
+```bash
+uv run agentstack run
+```
 
 Runs the agent project in development mode.<br>
 
+> Note: Always use `uv run` when executing AgentStack commands to ensure proper environment management.
+
 > 👀 Support for easy production deployment of agents is coming soon.
 
 ## Philosophy

agentstack/cli/cli.py

@@ -144,7 +144,7 @@ def init_project_builder(
         "    uv lock\n"
         "    uv sync\n\n"
         "  6. Try running your agent:\n"
-        "    agentstack run\n\n"
+        "    uv run agentstack run\n\n"
         "  Run `agentstack quickstart` or `agentstack docs` for next steps.\n"
     )
 

agentstack/main.py

@@ -1,6 +1,9 @@
 import sys
 import argparse
 import webbrowser
+import os
+import subprocess
+from pathlib import Path
 
 from agentstack import conf, auth
 from agentstack.cli import (
@@ -17,7 +20,26 @@
 from agentstack.update import check_for_updates
 
 
+def ensure_uv_environment():
+    """Ensure the command is running in a UV-managed environment."""
+    if not os.environ.get("VIRTUAL_ENV"):
+        # If not in a virtual environment, rerun the command with UV
+        args = ["uv", "run"] + sys.argv
+        try:
+            result = subprocess.run(args, check=True)
+            sys.exit(result.returncode)
+        except subprocess.CalledProcessError as e:
+            sys.exit(e.returncode)
+        except FileNotFoundError:
+            print("Error: UV is not installed. Please install UV first with: pip install uv")
+            sys.exit(1)
+
+
 def main():
+    # Ensure we're running in a UV environment for all commands except 'init'
+    if len(sys.argv) > 1 and sys.argv[1] != "init":
+        ensure_uv_environment()
+
     global_parser = argparse.ArgumentParser(add_help=False)
     global_parser.add_argument(
         "--path",