superqode 0.1.5__tar.gz → 0.1.7__tar.gz

{superqode-0.1.5/src/superqode.egg-info → superqode-0.1.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superqode
-Version: 0.1.5
+Version: 0.1.7
 Summary: SuperQode: Super Quality Engineering for Agentic Coding Teams
 Author-email: Shashi Jagtap <info@super-agentic.ai>
 Maintainer-email: Shashi Jagtap <info@super-agentic.ai>
@@ -69,9 +69,8 @@ Requires-Dist: mkdocs-minify-plugin>=0.7.0; extra == "docs"
 Dynamic: license-file
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/SuperagenticAI/superqode/main/assets/super-qode-header.png" alt="SuperQode Banner">
+  <img src="https://raw.githubusercontent.com/SuperagenticAI/superqode/main/assets/superqode.png" alt="SuperQode TUI">
 </p>
-
 <p align="center">
   <img src="https://raw.githubusercontent.com/SuperagenticAI/superqode/main/assets/superqode-logo.png" alt="SuperQode Logo" width="200">
 </p>
@@ -106,6 +105,8 @@ Dynamic: license-file
 
 ---
 
+
+
 ## What is SuperQode and SuperQE?
 
 **SuperQE** is the quality paradigm and automation CLI: Super Quality Engineering for Agentic AI. It uses QE coding agents to break and validate code written by coding agents. SuperQE can spawn a team of QE agents with different testing personas in a multi-agent setup to stress your code from many angles.
@@ -114,6 +115,14 @@ Dynamic: license-file
 
 **Note (Enterprise):** Enterprise adds powerful automation, deep evaluation testing, and enterprise integrations (Moltbot first; more bot integrations coming).
 
+## Demo Video
+
+Watch the demo: [SuperQode Demo](https://www.youtube.com/watch?v=x2V323HgXRk)
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/SuperagenticAI/superqode/main/assets/super-qode-header.png" alt="SuperQode Banner">
+</p>
+
 ## Quick Start
 
 ### Installation
@@ -127,7 +136,8 @@ uv tool install superqode
 pip install superqode
 ```
 
-**Alternate (No Python Required)**
+**Alternate (No Python Required, SuperQode TUI Only)**
+> Note: SuperQE (CLI) requires the Python install above (uv or pip).
 ```bash
 # Using Homebrew (macOS/Linux)
 brew install SuperagenticAI/superqode/superqode
@@ -144,10 +154,6 @@ cd your-project
 superqode
 ```
 
-<p align="center">
-  <img src="https://raw.githubusercontent.com/SuperagenticAI/superqode/main/assets/superqode.png" alt="SuperQode TUI">
-</p>
-
 **Automated QE (CI/CD)**
 ```bash
 cd your-project

{superqode-0.1.5 → superqode-0.1.7}/README.md

@@ -1,7 +1,6 @@
 <p align="center">
-  <img src="https://raw.githubusercontent.com/SuperagenticAI/superqode/main/assets/super-qode-header.png" alt="SuperQode Banner">
+  <img src="https://raw.githubusercontent.com/SuperagenticAI/superqode/main/assets/superqode.png" alt="SuperQode TUI">
 </p>
-
 <p align="center">
   <img src="https://raw.githubusercontent.com/SuperagenticAI/superqode/main/assets/superqode-logo.png" alt="SuperQode Logo" width="200">
 </p>
@@ -36,6 +35,8 @@
 
 ---
 
+
+
 ## What is SuperQode and SuperQE?
 
 **SuperQE** is the quality paradigm and automation CLI: Super Quality Engineering for Agentic AI. It uses QE coding agents to break and validate code written by coding agents. SuperQE can spawn a team of QE agents with different testing personas in a multi-agent setup to stress your code from many angles.
@@ -44,6 +45,14 @@
 
 **Note (Enterprise):** Enterprise adds powerful automation, deep evaluation testing, and enterprise integrations (Moltbot first; more bot integrations coming).
 
+## Demo Video
+
+Watch the demo: [SuperQode Demo](https://www.youtube.com/watch?v=x2V323HgXRk)
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/SuperagenticAI/superqode/main/assets/super-qode-header.png" alt="SuperQode Banner">
+</p>
+
 ## Quick Start
 
 ### Installation
@@ -57,7 +66,8 @@ uv tool install superqode
 pip install superqode
 ```
 
-**Alternate (No Python Required)**
+**Alternate (No Python Required, SuperQode TUI Only)**
+> Note: SuperQE (CLI) requires the Python install above (uv or pip).
 ```bash
 # Using Homebrew (macOS/Linux)
 brew install SuperagenticAI/superqode/superqode
@@ -74,10 +84,6 @@ cd your-project
 superqode
 ```
 
-<p align="center">
-  <img src="https://raw.githubusercontent.com/SuperagenticAI/superqode/main/assets/superqode.png" alt="SuperQode TUI">
-</p>
-
 **Automated QE (CI/CD)**
 ```bash
 cd your-project

{superqode-0.1.5 → superqode-0.1.7}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "superqode"
-version = "0.1.5"
+version = "0.1.7"
 description = "SuperQode: Super Quality Engineering for Agentic Coding Teams"
 readme = "README.md"
 requires-python = ">=3.12"

{superqode-0.1.5 → superqode-0.1.7}/src/superqode/__init__.py

@@ -30,4 +30,4 @@ __all__ = [
     "sidebar",
 ]
 
-__version__ = "0.1.5"
+__version__ = "0.1.6"

{superqode-0.1.5 → superqode-0.1.7}/src/superqode/acp_discovery.py

@@ -365,10 +365,10 @@ KNOWN_AGENTS: List[Dict[str, Any]] = [
     {
         "name": "fast-agent",
         "short_name": "fast-agent",
-        "command": ["fast-agent", "--acp"],
+        "command": ["fast-agent-acp", "-x"],
         "alt_commands": [
-            ["fastagent", "--acp"],
-            ["npx", "-y", "fast-agent", "--acp"],
+            ["fast-agent-acp"],
+            ["fast-agent", "serve","--transport","acp"],
         ],
         "icon": "🚀",
         "color": "#14b8a6",
@@ -675,6 +675,7 @@ class ACPDiscovery:
                 AgentModel(id="claude-3-5-sonnet", name="Claude 3.5 Sonnet", is_free=True),
                 AgentModel(id="gpt-4o", name="GPT-4o", is_free=True),
                 AgentModel(id="gemini-2.5-pro", name="Gemini 2.5 Pro", is_free=True),
+                AgentModel(id="kimi-k2.5-free", name="Kimi K2.5 (Free)", is_free=True),
             ],
             # Stakpak
             "stakpak": [

{superqode-0.1.5 → superqode-0.1.7}/src/superqode/agents/acp_registry.py

@@ -243,7 +243,7 @@ ACP_AGENTS_REGISTRY: dict[str, AgentMetadata] = {
         "author_name": "fast-agent",
         "author_url": "https://github.com/evalstate",
         "description": "Create and interact with sophisticated Agents and Workflows in minutes. MCP native.",
-        "run_command": "fast-agent --acp",
+        "run_command": "fast-agent-acp -x",
         "status": "available",
         "installation_command": "uv tool install fast-agent-mcp",
         "installation_instructions": "Install fast-agent via uv. Native MCP support.",

{superqode-0.1.5 → superqode-0.1.7}/src/superqode/agents/messaging.py

@@ -15,12 +15,14 @@ def map_model_to_opencode(model_name: str) -> str:
     model_mapping = {
         "glm-4.7": "glm-4.7-free",
         "grok-code": "grok-code",
+        "kimi-k2.5": "kimi-k2.5-free",
         "gpt-5-nano": "gpt-5-nano",
         "big-pickle": "big-pickle",
         "minimax-m2.1": "minimax-m2.1-free",
         # Strip provider prefix if present
         "opencode/glm-4.7-free": "glm-4.7-free",
         "opencode/grok-code": "grok-code",
+        "opencode/kimi-k2.5-free": "kimi-k2.5-free",
         "opencode/gpt-5-nano": "gpt-5-nano",
         "opencode/big-pickle": "big-pickle",
         "opencode/minimax-m2.1-free": "minimax-m2.1-free",

{superqode-0.1.5 → superqode-0.1.7}/src/superqode/agents/registry.py

@@ -232,7 +232,7 @@ AGENTS: Dict[str, AgentDef] = {
         docs_url="https://github.com/evalstate/fast-agent",
         capabilities=["Workflows", "MCP native", "Fast setup"],
         connection_type="stdio",
-        command="fast-agent --acp",
+        command="fast-agent-acp",
     ),
     "llmling-agent": AgentDef(
         id="llmling-agent",

{superqode-0.1.5 → superqode-0.1.7}/src/superqode/app_main.py

@@ -648,6 +648,7 @@ class SuperQodeApp(App):
         return [
             {"id": "glm-4.7-free", "name": "GLM-4.7 (Free)", "context": 8192},
             {"id": "grok-code", "name": "Grok Code", "context": 4096},
+            {"id": "kimi-k2.5-free", "name": "Kimi K2.5 (Free)", "context": 8192},
             {"id": "gpt-5-nano", "name": "GPT-5 Nano", "context": 4096},
             {"id": "minimax-m2.1-free", "name": "MiniMax M2.1 (Free)", "context": 4096},
             {"id": "big-pickle", "name": "Big Pickle", "context": 2048},
@@ -823,6 +824,13 @@ class SuperQodeApp(App):
                 "recommended": True,
                 "desc": "xAI - Fast coding model",
             },
+            {
+                "id": "opencode/kimi-k2.5-free",
+                "name": "Kimi K2.5",
+                "free": True,
+                "recommended": True,
+                "desc": "Moonshot AI - K2.5 free tier",
+            },
             {
                 "id": "opencode/minimax-m2.1-free",
                 "name": "MiniMax M2.1",
@@ -3552,7 +3560,9 @@ class SuperQodeApp(App):
             log.add_info(
                 "⚡ Power QE roles: unit, integration, api, ui, accessibility, security, usability"
             )
-            log.add_info("💡 Update each role's job_description in superqode.yaml for best results.")
+            log.add_info(
+                "💡 Update each role's job_description in superqode.yaml for best results."
+            )
         else:
             # Fallback: create basic config if template not found
             default_config = """# =============================================================================
@@ -3703,7 +3713,9 @@ team:
             log.add_info(
                 "⚡ Power QE roles: unit, integration, api, ui, accessibility, security, usability"
             )
-            log.add_info("💡 Update each role's job_description in superqode.yaml for best results.")
+            log.add_info(
+                "💡 Update each role's job_description in superqode.yaml for best results."
+            )
 
         t = Text()
         t.append("\n  Quick start:\n", style=THEME["muted"])
@@ -3995,12 +4007,6 @@ team:
             if self._handle_byok_model_selection(text, log):
                 return
 
-        # Check if user is asking about the model - intercept and answer directly
-        if self._is_model_query(text):
-            log.add_user(text)
-            self._answer_model_query(log)
-            return
-
         # Parse @file references and include file content
         file_context = ""
         if "@" in text:
@@ -4945,7 +4951,7 @@ team:
             command = "cagent --acp"
             model_display = f"cagent/{model}" if model else "cagent/auto"
         elif agent_type == "fast-agent":
-            command = "fast-agent --acp"
+            command = "fast-agent-acp -x"
             model_display = f"fast-agent/{model}" if model else "fast-agent/auto"
         elif agent_type == "llmling-agent":
             command = "llmling-agent --acp"
@@ -5204,9 +5210,12 @@ team:
                 if getattr(client, "_process", None) is not None:
                     self._agent_process = client._process  # type: ignore[attr-defined]
 
-                # Set model for agents that support it
-                if model and agent_type in ("codex", "openhands"):
-                    await client.set_model(model)
+                # Set model for agents that support ACP model selection
+                if model and agent_type in ("codex", "openhands", "opencode"):
+                    model_id = model
+                    if agent_type == "opencode" and not model_id.startswith("opencode/"):
+                        model_id = f"opencode/{model_id}"
+                    await client.set_model(model_id)
 
                 prompt_task = asyncio.create_task(client.send_prompt(message))
 
@@ -10071,6 +10080,8 @@ team:
                     "glm-4.7": "glm-4.7-free",
                     "glm-4.7-free": "glm-4.7-free",
                     "grok-code": "grok-code",
+                    "kimi-k2.5": "kimi-k2.5-free",
+                    "kimi-k2.5-free": "kimi-k2.5-free",
                     "minimax-m2.1": "minimax-m2.1-free",
                     "minimax-m2.1-free": "minimax-m2.1-free",
                     "gpt-5-nano": "gpt-5-nano",

{superqode-0.1.5 → superqode-0.1.7}/src/superqode/main.py

@@ -863,8 +863,8 @@ team:
           Ensure security, monitoring, and deployment best practices.
 
 # =============================================================================
-# Available free models: glm-4.7-free, grok-code, gpt-5-nano,
-#                        minimax-m2.1-free, big-pickle
+# Available free models: glm-4.7-free, grok-code, kimi-k2.5-free,
+#                        gpt-5-nano, minimax-m2.1-free, big-pickle
 # =============================================================================
 """
 

{superqode-0.1.5 → superqode-0.1.7}/src/superqode/providers/local/mlx.py

@@ -142,6 +142,36 @@ class MLXClient(LocalProviderClient):
 
         return models
 
+    @staticmethod
+    def _model_from_cache(model_info: Dict[str, Any], running: bool = False) -> LocalModel:
+        """Build a LocalModel from cached HuggingFace model metadata."""
+        model_id = model_info["id"]
+
+        format_note = ""
+        if "mlx" in model_id.lower():
+            format_note = " (MLX format)"
+        elif "4bit" in model_id.lower() or "8bit" in model_id.lower():
+            format_note = " (quantized)"
+
+        return LocalModel(
+            id=model_id,
+            name=f"{model_id.split('/')[-1]} (cached){format_note}",
+            size_bytes=model_info["size_bytes"],
+            quantization=detect_quantization(model_id),
+            context_window=4096,
+            supports_tools=likely_supports_tools(model_id),
+            supports_vision=False,
+            family=detect_model_family(model_id),
+            running=running,
+            modified_at=model_info.get("modified"),
+            details={
+                "cached_path": model_info.get("path"),
+                "source": "huggingface_cache",
+                "supported_formats": ["MLX", "safetensors"],
+                "notes": "Works with mlx_lm.convert and mlx_lm.server",
+            },
+        )
+
     @staticmethod
     def _get_directory_size(path: str) -> int:
         """Get total size of directory in bytes."""
@@ -311,7 +341,7 @@ class MLXClient(LocalProviderClient):
     async def list_models(self) -> List[LocalModel]:
         """List available models from MLX server."""
         try:
-            response = await self._async_request("GET", "/v1/models")
+            response = await self._async_request("GET", "/v1/models", timeout=8.0)
             models = response.get("data", [])
 
             result = []

{superqode-0.1.5 → superqode-0.1.7}/src/superqode/providers/registry.py

@@ -433,6 +433,7 @@ PROVIDERS: Dict[str, ProviderDef] = {
         example_models=[
             "glm-4.7-free",
             "grok-code",
+            "kimi-k2.5-free",
             "gpt-5-nano",
             "minimax-m2.1-free",
             "big-pickle",
@@ -440,6 +441,7 @@ PROVIDERS: Dict[str, ProviderDef] = {
         free_models=[
             "glm-4.7-free",
             "grok-code",
+            "kimi-k2.5-free",
             "gpt-5-nano",
             "minimax-m2.1-free",
             "big-pickle",

{superqode-0.1.5 → superqode-0.1.7}/src/superqode/widgets/provider_connect.py

@@ -420,7 +420,11 @@ class ProviderConnectWidget(Container):
                 return
 
             # Try getting models from the database (includes live models.dev data)
-            db_models = get_models_for_provider(provider_id)
+            # Only use DB models if we did not load local models for local providers.
+            if not self._models:
+                db_models = get_models_for_provider(provider_id)
+            else:
+                db_models = {}
 
             if db_models:
                 # Store both model IDs and their info
@@ -468,11 +472,50 @@ class ProviderConnectWidget(Container):
                 return
 
             client = client_class()
+
+            if provider_id == "mlx":
+                # MLX server can be slow to respond during model load.
+                # Try listing models directly before falling back to cache.
+                models = []
+                try:
+                    models = await client.list_models()
+                except Exception:
+                    models = []
+
+                if not models:
+                    try:
+                        models = MLXClient.get_available_models()
+                    except Exception:
+                        models = []
+
+                cached = []
+                try:
+                    cache_models = MLXClient.discover_huggingface_models()
+                    for model_info in cache_models:
+                        model_id = model_info["id"]
+                        if any(m.id == model_id for m in models):
+                            continue
+                        cached.append(MLXClient._model_from_cache(model_info, running=False))
+                except Exception:
+                    cached = []
+
+                # Running models first, then cached models
+                models = models + cached
+                models_sorted = sorted(models, key=lambda m: (not m.running, m.name))
+
+                self._models = [m.id for m in models_sorted]
+                self._local_models = {m.id: m for m in models_sorted}
+                self._model_info = {}
+                return
+
             if await client.is_available():
                 models = await client.list_models()
 
-                self._models = [m.id for m in models]
-                self._local_models = {m.id: m for m in models}
+                # Preserve order while ensuring running models appear first.
+                models_sorted = sorted(models, key=lambda m: (not m.running, m.name))
+
+                self._models = [m.id for m in models_sorted]
+                self._local_models = {m.id: m for m in models_sorted}
                 self._model_info = {}
             else:
                 self._models = []

{superqode-0.1.5 → superqode-0.1.7/src/superqode.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: superqode
-Version: 0.1.5
+Version: 0.1.7
 Summary: SuperQode: Super Quality Engineering for Agentic Coding Teams
 Author-email: Shashi Jagtap <info@super-agentic.ai>
 Maintainer-email: Shashi Jagtap <info@super-agentic.ai>
@@ -69,9 +69,8 @@ Requires-Dist: mkdocs-minify-plugin>=0.7.0; extra == "docs"
 Dynamic: license-file
 
 <p align="center">
-  <img src="https://raw.githubusercontent.com/SuperagenticAI/superqode/main/assets/super-qode-header.png" alt="SuperQode Banner">
+  <img src="https://raw.githubusercontent.com/SuperagenticAI/superqode/main/assets/superqode.png" alt="SuperQode TUI">
 </p>
-
 <p align="center">
   <img src="https://raw.githubusercontent.com/SuperagenticAI/superqode/main/assets/superqode-logo.png" alt="SuperQode Logo" width="200">
 </p>
@@ -106,6 +105,8 @@ Dynamic: license-file
 
 ---
 
+
+
 ## What is SuperQode and SuperQE?
 
 **SuperQE** is the quality paradigm and automation CLI: Super Quality Engineering for Agentic AI. It uses QE coding agents to break and validate code written by coding agents. SuperQE can spawn a team of QE agents with different testing personas in a multi-agent setup to stress your code from many angles.
@@ -114,6 +115,14 @@ Dynamic: license-file
 
 **Note (Enterprise):** Enterprise adds powerful automation, deep evaluation testing, and enterprise integrations (Moltbot first; more bot integrations coming).
 
+## Demo Video
+
+Watch the demo: [SuperQode Demo](https://www.youtube.com/watch?v=x2V323HgXRk)
+
+<p align="center">
+  <img src="https://raw.githubusercontent.com/SuperagenticAI/superqode/main/assets/super-qode-header.png" alt="SuperQode Banner">
+</p>
+
 ## Quick Start
 
 ### Installation
@@ -127,7 +136,8 @@ uv tool install superqode
 pip install superqode
 ```
 
-**Alternate (No Python Required)**
+**Alternate (No Python Required, SuperQode TUI Only)**
+> Note: SuperQE (CLI) requires the Python install above (uv or pip).
 ```bash
 # Using Homebrew (macOS/Linux)
 brew install SuperagenticAI/superqode/superqode
@@ -144,10 +154,6 @@ cd your-project
 superqode
 ```
 
-<p align="center">
-  <img src="https://raw.githubusercontent.com/SuperagenticAI/superqode/main/assets/superqode.png" alt="SuperQode TUI">
-</p>
-
 **Automated QE (CI/CD)**
 ```bash
 cd your-project