Cla add

.env.example

@@ -1,3 +1,4 @@
+<<<<<<< HEAD
 # Cortex Linux Environment Configuration
 # Copy this file to .env and configure your settings
 
@@ -59,3 +60,10 @@ OLLAMA_MODEL=llama3.2
 #   - ~/.cortex/.env
 #   - /etc/cortex/.env (Linux only)
 #
+=======
+# Example .env file for Cortex
+# Copy this to .env and fill in your API keys
+
+OPENAI_API_KEY=sk-your-openai-key-here
+ANTHROPIC_API_KEY=sk-ant-your-anthropic-key-here
+>>>>>>> 34c66df (feat: seamless onboarding—auto-create .env from .env.example, improved wizard flow)

.github/cla-signers.json

@@ -118,7 +118,8 @@
       "name": "Shree Milind Jejurikar",
       "github_username": "ShreeJejurikar",
       "emails": [
-        "shreemj8@gmail.com"
+        "shreemj8@gmail.com",
+        "shreemj0407@example.com"
       ],
       "signed_date": "2026-01-02",
       "cla_version": "1.0"
@@ -190,7 +191,8 @@
       "name": "Jay Surse",
       "github_username": "jaysurse",
       "emails": [
-        "jaysurse07@gmail.com"
+        "jaysurse07@gmail.com",
+        "jay@cortex.local"
       ],
       "signed_date": "2026-01-09",
       "cla_version": "1.0"

cortex/api_key_detector.py

@@ -692,3 +692,34 @@ def setup_api_key() -> tuple[bool, str | None, str | None]:
         return (True, key, provider)
 
     return (False, None, None)
+
+
+# Convenience functions for backward compatibility
+def detect_api_key(provider: str) -> str | None:
+    """
+    Detect API key for a specific provider.
+
+    Args:
+        provider: The provider name ('anthropic', 'openai')
+
+    Returns:
+        The API key or None if not found
+    """
+    found, key, detected_provider, source = auto_detect_api_key()
+    if found and detected_provider == provider:
+        return key
+    return None
+
+
+def get_detected_provider() -> str | None:
+    """
+    Get the detected provider name.
+
+    Returns:
+        The provider name or None if not detected
+    """
+    found, key, provider, source = auto_detect_api_key()
+    return provider if found else None
+
+
+SUPPORTED_PROVIDERS = ["anthropic", "openai", "ollama"]

cortex/cli.py

@@ -22,6 +22,7 @@
     format_package_list,
 )
 from cortex.env_manager import EnvironmentManager, get_env_manager
+from cortex.first_run_wizard import FirstRunWizard
 from cortex.i18n import (
     SUPPORTED_LANGUAGES,
     LanguageConfig,
@@ -148,23 +149,37 @@ def _debug(self, message: str):
         if self.verbose:
             console.print(f"[dim][DEBUG] {message}[/dim]")
 
-    def _get_api_key(self) -> str | None:
-        # 1. Check explicit provider override first (fake/ollama need no key)
-        explicit_provider = os.environ.get("CORTEX_PROVIDER", "").lower()
-        if explicit_provider == "fake":
-            self._debug("Using Fake provider for testing")
-            return "fake-key"
-        if explicit_provider == "ollama":
-            self._debug("Using Ollama (no API key required)")
+    def _get_api_key_for_provider(self, provider: str) -> str | None:
+        """Get API key for a specific provider."""
+        if provider == "ollama":
             return "ollama-local"
+        if provider == "fake":
+            return "fake-key"
+        if provider == "claude":
+            key = os.environ.get("ANTHROPIC_API_KEY")
+            if key and key.strip().startswith("sk-ant-"):
+                return key.strip()
+        elif provider == "openai":
+            key = os.environ.get("OPENAI_API_KEY")
+            if key and key.strip().startswith("sk-"):
+                return key.strip()
+        return None
 
-        # 2. Try auto-detection + prompt to save (setup_api_key handles both)
-        success, key, detected_provider = setup_api_key()
-        if success:
-            self._debug(f"Using {detected_provider} API key")
-            # Store detected provider so _get_provider can use it
-            self._detected_provider = detected_provider
+    def _get_api_key(self) -> str | None:
+        """Get API key for the current provider."""
+        provider = self._get_provider()
+        key = self._get_api_key_for_provider(provider)
+        if key:
             return key
+        # If provider is ollama or no key is set, always fallback to ollama-local
+        if provider == "ollama" or not (
+            os.environ.get("OPENAI_API_KEY") or os.environ.get("ANTHROPIC_API_KEY")
+        ):
+            return "ollama-local"
+        # Otherwise, prompt user for setup
+        self._print_error("No valid API key found.")
+        cx_print("Run [bold]cortex wizard[/bold] to configure your API key.", "info")
+        cx_print("Or use [bold]CORTEX_PROVIDER=ollama[/bold] for offline mode.", "info")
 
         # Still no key
         self._print_error(t("api_key.not_found"))
@@ -191,7 +206,7 @@ def _get_provider(self) -> str:
         elif os.environ.get("OPENAI_API_KEY"):
             return "openai"
 
-        # Fallback to Ollama for offline mode
+        # No API keys available - default to Ollama for offline mode
         return "ollama"
 
     def _print_status(self, emoji: str, message: str):
@@ -822,6 +837,7 @@ def install(
         execute: bool = False,
         dry_run: bool = False,
         parallel: bool = False,
+        forced_provider: str | None = None,
     ):
         # Validate input first
         is_valid, error = validate_install_request(software)
@@ -842,39 +858,51 @@ def install(
                 "pip3 install jupyter numpy pandas"
             )
 
-        api_key = self._get_api_key()
-        if not api_key:
-            return 1
-
-        provider = self._get_provider()
-        self._debug(f"Using provider: {provider}")
-        self._debug(f"API key: {api_key[:10]}...{api_key[-4:]}")
-
-        # Initialize installation history
+        # Try providers in order
+        initial_provider = forced_provider or self._get_provider()
+        providers_to_try = [initial_provider]
+        if initial_provider in ["claude", "openai"]:
+            other_provider = "openai" if initial_provider == "claude" else "claude"
+            if self._get_api_key_for_provider(other_provider):
+                providers_to_try.append(other_provider)
+
+        commands = None
+        provider = None  # noqa: F841 - assigned in loop
+        api_key = None
         history = InstallationHistory()
-        install_id = None
         start_time = datetime.now()
+        for try_provider in providers_to_try:
+            try:
+                try_api_key = self._get_api_key_for_provider(try_provider) or "dummy-key"
+                self._debug(f"Trying provider: {try_provider}")
+                interpreter = CommandInterpreter(api_key=try_api_key, provider=try_provider)
 
-        try:
-            self._print_status("🧠", t("install.analyzing"))
-
-            interpreter = CommandInterpreter(api_key=api_key, provider=provider)
+                self._print_status("🧠", t("install.analyzing"))
 
-            self._print_status("📦", t("install.planning"))
+                for _ in range(10):
+                    self._animate_spinner(t("progress.analyzing_requirements"))
+                self._clear_line()
 
-            for _ in range(10):
-                self._animate_spinner(t("progress.analyzing_requirements"))
-            self._clear_line()
+                commands = interpreter.parse(f"install {software}")
 
-            commands = interpreter.parse(f"install {software}")
+                if commands:
+                    provider = try_provider
+                    api_key = try_api_key
+                    break
+                else:
+                    self._debug(f"No commands generated with {try_provider}")
+            except (RuntimeError, Exception) as e:
+                self._debug(f"API call failed with {try_provider}: {e}")
+                continue
 
-            if not commands:
-                self._print_error(t("install.no_commands"))
-                return 1
+        if not commands:
+            self._print_error(t("install.no_commands"))
+            return 1
 
+        try:
+            install_id = None
             # Extract packages from commands for tracking
             packages = history._extract_packages_from_commands(commands)
-
             # Record installation start
             if execute or dry_run:
                 install_id = history.record_installation(
@@ -1994,14 +2022,15 @@ def wizard(self):
         """Interactive setup wizard for API key configuration"""
         show_banner()
         console.print()
-        cx_print("Welcome to Cortex Setup Wizard!", "success")
-        console.print()
-        # (Simplified for brevity - keeps existing logic)
-        cx_print("Please export your API key in your shell profile.", "info")
-        return 0
+        # Run the actual first-run wizard
+        wizard = FirstRunWizard(interactive=True)
+        success = wizard.run()
+        return 0 if success else 1
 
     def env(self, args: argparse.Namespace) -> int:
         """Handle environment variable management commands."""
+        import sys
+
         env_mgr = get_env_manager()
 
         # Handle subcommand routing
@@ -2044,15 +2073,8 @@ def env(self, args: argparse.Namespace) -> int:
             else:
                 self._print_error(f"Unknown env subcommand: {action}")
                 return 1
-        except (ValueError, OSError) as e:
-            self._print_error(f"Environment operation failed: {e}")
-            return 1
         except Exception as e:
-            self._print_error(f"Unexpected error: {e}")
-            if self.verbose:
-                import traceback
-
-                traceback.print_exc()
+            self._print_error(f"Environment operation failed: {e}")
             return 1
 
     def _env_set(self, env_mgr: EnvironmentManager, args: argparse.Namespace) -> int:
@@ -2085,8 +2107,7 @@ def _env_set(self, env_mgr: EnvironmentManager, args: argparse.Namespace) -> int
             return 1
         except ImportError as e:
             self._print_error(str(e))
-            if "cryptography" in str(e).lower():
-                cx_print("Install with: pip install cryptography", "info")
+            cx_print("Install with: pip install cryptography", "info")
             return 1
 
     def _env_get(self, env_mgr: EnvironmentManager, args: argparse.Namespace) -> int:
@@ -2217,8 +2238,7 @@ def _env_import(self, env_mgr: EnvironmentManager, args: argparse.Namespace) ->
             else:
                 cx_print("No variables imported", "info")
 
-            # Return success (0) even with partial errors - some vars imported successfully
-            return 0
+            return 0 if not errors else 1
 
         except FileNotFoundError:
             self._print_error(f"File not found: {input_file}")

cortex/env_loader.py

@@ -33,11 +33,24 @@ def get_env_file_locations() -> list[Path]:
     cwd_env = Path.cwd() / ".env"
     locations.append(cwd_env)
 
-    # 2. User's home directory .cortex folder
+    # 2. Parent directory (for project root .env)
+    parent_env = Path.cwd().parent / ".env"
+    locations.append(parent_env)
+
+    # 3. Cortex package directory .env
+    try:
+        import cortex
+
+        cortex_dir = Path(cortex.__file__).parent / ".env"
+        locations.append(cortex_dir)
+    except ImportError:
+        pass
+
+    # 4. User's home directory .cortex folder
     home_cortex_env = Path.home() / ".cortex" / ".env"
     locations.append(home_cortex_env)
 
-    # 3. System-wide config (Linux only)
+    # 5. System-wide config (Linux only)
     if os.name == "posix":
         system_env = Path("/etc/cortex/.env")
         locations.append(system_env)