stackops 26.6.3__tar.gz → 26.6.4__tar.gz

{stackops-26.6.3/src/stackops.egg-info → stackops-26.6.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: stackops
-Version: 26.6.3
+Version: 26.6.4
 Summary: Developer Stack Manager
 Author-email: Alex Al-Saffar <programmer@usa.com>
 License: Apache 2.0
@@ -14,7 +14,6 @@ Description-Content-Type: text/markdown
 Requires-Dist: fire>=0.7.1
 Requires-Dist: gitpython>=3.1.46
 Requires-Dist: joblib>=1.5.3
-Requires-Dist: paramiko>=4.0.0
 Requires-Dist: psutil>=7.2.2
 Requires-Dist: pyyaml>=6.0.3
 Requires-Dist: questionary>=2.1.1
@@ -41,7 +40,7 @@ Provides-Extra: plot
 
 </div>
 
-StackOps is a cross-platform CLI for managing your development stack. It is package installer, configurator, dotfile/secrets manager, data and code sync solution, command launcher, processes orchestator (is there anything else?) all wrapped into one solution. As such, it should take a few minutes to make a fresh new machine to look like the machine you were customizing for 10 years.
+StackOps is a cross-platform CLI for managing your development stack. It is package installer, configurator, dotfile/secrets manager, data and code sync solution, command launcher, processes orchestrator (is there anything else?) all wrapped into one solution. As such, it should take a few minutes to make a fresh new machine to look like the machine you were customizing for 10 years.
 
 
 | Before | After |
@@ -102,13 +101,32 @@ devops config copy-assets all
 devops config sync down \
   --sensitivity public \
   --method copy \
-  --on-conflict overwrite-default-path \
+  --on-conflict throw-error \
   --which all
 devops config terminal config-shell --which default
 devops install --group termabc
 ```
 
 
+## CLI
+
+StackOps exposes standalone commands and an umbrella wrapper:
+
+| Command | Purpose |
+| --- | --- |
+| `devops` | Package installation, repo automation, config/data sync, self-management, networking, script execution, vault |
+| `cloud` | Cloud sync, copy, mount, and SSH transfer helpers |
+| `terminal` | Terminal session and layout management |
+| `agents` | AI agent scaffolding, MCP catalog installs, prompt runs, parallel workflows |
+| `utils` | General-purpose utility commands |
+| `fire` | File, function, notebook, and app runner |
+| `preview` | File preview and `uv run` backend launcher |
+| `seek` | Interactive search across files, text matches, and symbols |
+| `stackops` | Umbrella wrapper that routes into all of the above |
+
+Run `<command> --help` for details, or `stackops --help` to see the full tree.
+
+
 ## Author
 
 Alex Al-Saffar. [email](mailto:programmer@usa.com)

{stackops-26.6.3 → stackops-26.6.4}/README.md

@@ -13,7 +13,7 @@
 
 </div>
 
-StackOps is a cross-platform CLI for managing your development stack. It is package installer, configurator, dotfile/secrets manager, data and code sync solution, command launcher, processes orchestator (is there anything else?) all wrapped into one solution. As such, it should take a few minutes to make a fresh new machine to look like the machine you were customizing for 10 years.
+StackOps is a cross-platform CLI for managing your development stack. It is package installer, configurator, dotfile/secrets manager, data and code sync solution, command launcher, processes orchestrator (is there anything else?) all wrapped into one solution. As such, it should take a few minutes to make a fresh new machine to look like the machine you were customizing for 10 years.
 
 
 | Before | After |
@@ -74,13 +74,32 @@ devops config copy-assets all
 devops config sync down \
   --sensitivity public \
   --method copy \
-  --on-conflict overwrite-default-path \
+  --on-conflict throw-error \
   --which all
 devops config terminal config-shell --which default
 devops install --group termabc
 ```
 
 
+## CLI
+
+StackOps exposes standalone commands and an umbrella wrapper:
+
+| Command | Purpose |
+| --- | --- |
+| `devops` | Package installation, repo automation, config/data sync, self-management, networking, script execution, vault |
+| `cloud` | Cloud sync, copy, mount, and SSH transfer helpers |
+| `terminal` | Terminal session and layout management |
+| `agents` | AI agent scaffolding, MCP catalog installs, prompt runs, parallel workflows |
+| `utils` | General-purpose utility commands |
+| `fire` | File, function, notebook, and app runner |
+| `preview` | File preview and `uv run` backend launcher |
+| `seek` | Interactive search across files, text matches, and symbols |
+| `stackops` | Umbrella wrapper that routes into all of the above |
+
+Run `<command> --help` for details, or `stackops --help` to see the full tree.
+
+
 ## Author
 
 Alex Al-Saffar. [email](mailto:programmer@usa.com)

{stackops-26.6.3 → stackops-26.6.4}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "stackops"
-version = "26.6.3"
+version = "26.6.4"
 description = "Developer Stack Manager"
 readme = "README.md"
 license = {text = "Apache 2.0"}
@@ -23,7 +23,6 @@ dependencies = [
     "fire>=0.7.1",
     "gitpython>=3.1.46",
     "joblib>=1.5.3",
-    "paramiko>=4.0.0",
     "psutil>=7.2.2",
     "pyyaml>=6.0.3",
     "questionary>=2.1.1",
@@ -87,6 +86,7 @@ dev = [
     "mypy>=1.19.1",
     "numpy>=2.4.3",
     "pandas>=3.0.1",
+    "paramiko>=5.0.0",
     "plotly>=6.6.0",
     "polars>=1.39.3",
     "pre-commit>=4.5.1",
@@ -143,6 +143,9 @@ plot = [
 ]
 
 
+# [tool.uv]
+# default-groups = []
+
 [tool.pycrucible]
 entry = "src/stackops/scripts/python/devops.py"
 [tool.pycrucible.options]

stackops-26.6.4/src/stackops/cluster/sessions_managers/helpers/enhanced_command_runner.py

@@ -0,0 +1,66 @@
+#!/usr/bin/env python3
+"""Enhanced command execution utilities with Rich formatting."""
+
+import subprocess
+
+from rich.console import Console
+from rich.panel import Panel
+from rich.progress import Progress, SpinnerColumn, TextColumn
+
+console = Console()
+
+
+def run_enhanced_command(
+    command: str,
+    description: str | None,
+    show_progress: bool,
+    timeout: int | None,
+) -> dict[str, object]:
+    if description is None:
+        description = f"Executing: {command[:50]}..."
+
+    try:
+        if show_progress:
+            with Progress(SpinnerColumn(), TextColumn("[progress.description]{task.description}"), console=console, transient=True) as progress:
+                task = progress.add_task(f"[cyan]{description}[/cyan]", total=None)
+
+                result = subprocess.run(command, shell=True, capture_output=True, text=True, timeout=timeout)
+
+                progress.update(task, completed=True)
+        else:
+            result = subprocess.run(command, shell=True, capture_output=True, text=True, timeout=timeout)
+
+        stdout = result.stdout.strip() if result.stdout else ""
+        stderr = result.stderr.strip() if result.stderr else ""
+
+        if "Session:" in stdout and "successfully deleted" in stdout:
+            console.print(f"[bold red]{stdout}[/bold red]")
+
+        if "Pseudo-terminal will not be allocated" in stderr:
+            console.print("[dim yellow]ℹ️  Note: Running in non-interactive mode[/dim yellow]")
+            stderr = stderr.replace("Pseudo-terminal will not be allocated because stdin is not a terminal.\n", "")
+
+        if result.returncode == 0:
+            if stdout and "Session:" not in stdout:
+                console.print(f"[green]{stdout}[/green]")
+            return {"success": True, "returncode": result.returncode, "stdout": stdout, "stderr": stderr}
+        else:
+            if stderr:
+                console.print(f"[bold red]Error:[/bold red] [red]{stderr}[/red]")
+            return {"success": False, "returncode": result.returncode, "stdout": stdout, "stderr": stderr}
+
+    except subprocess.TimeoutExpired:
+        console.print(f"[bold red]⏰ Command timed out after {timeout} seconds[/bold red]")
+        return {"success": False, "error": "Timeout", "timeout": timeout}
+    except Exception as exc:
+        console.print(f"[bold red]💥 Unexpected error:[/bold red] [red]{str(exc)}[/red]")
+        return {"success": False, "error": str(exc)}
+
+
+if __name__ == "__main__":
+    # Demo the enhanced command execution
+    console.print(Panel.fit("🎨 Enhanced Command Execution Demo", style="bold cyan"))
+
+    # Test with a simple command
+    result = run_enhanced_command("echo 'Hello, Rich world!'", "Testing enhanced output", True, None)
+    console.print(f"Result: {result}")

stackops-26.6.4/src/stackops/cluster/sessions_managers/monitoring_types.py

@@ -0,0 +1,42 @@
+from typing import NotRequired, TypedDict
+
+
+class ProcessInfo(TypedDict):
+    pid: int
+    name: str
+    cmdline: list[str]
+    status: str
+    cmdline_str: NotRequired[str]
+    create_time: NotRequired[float]
+    is_direct_command: NotRequired[bool]
+    verified_alive: NotRequired[bool]
+    memory_mb: NotRequired[float]
+
+
+class CommandStatus(TypedDict):
+    status: str
+    running: bool
+    processes: list[ProcessInfo]
+    command: str
+    tab_name: str
+    cwd: NotRequired[str]
+    error: NotRequired[str]
+    pid: NotRequired[int]
+    remote: NotRequired[str]
+    check_timestamp: NotRequired[str | float]
+    method: NotRequired[str]
+    raw_output: NotRequired[str]
+    verification_method: NotRequired[str]
+
+
+class StartResult(TypedDict):
+    success: bool
+    message: NotRequired[str]
+    error: NotRequired[str]
+
+
+class ActiveSessionInfo(TypedDict):
+    session_name: str
+    is_active: bool
+    tab_count: int
+    tabs: list[str]

{stackops-26.6.3 → stackops-26.6.4}/src/stackops/cluster/sessions_managers/session_conflict.py

@@ -5,18 +5,20 @@ import subprocess
 from typing import Literal, NotRequired, TypedDict
 
 
-SessionBackend = Literal["zellij", "tmux", "windows-terminal"]
+SessionBackend = Literal["tmux", "windows-terminal"]
 SessionConflictActionLoose = Literal[
     "restart", "r",
     "rename", "n",
     "error", "e",
+    "skip", "s",
     "mergeOverwrite", "m",
-    "mergeSkip", "s",
+    "mergeSkip", "M",
 ]
 SessionConflictAction = Literal[
     "restart",
     "rename",
     "error",
+    "skip",
     "mergeOverwrite",
     "mergeSkip",
 ]
@@ -27,10 +29,12 @@ SessionConflictActionLoose2Strict: dict[SessionConflictActionLoose, SessionConfl
     "n": "rename",
     "error": "error",
     "e": "error",
+    "skip": "skip",
+    "s": "skip",
     "mergeOverwrite": "mergeOverwrite",
     "m": "mergeOverwrite",
     "mergeSkip": "mergeSkip",
-    "s": "mergeSkip",
+    "M": "mergeSkip",
 }
 
 ConflictSource = Literal["existing", "duplicate"]
@@ -39,6 +43,7 @@ SUPPORTED_SESSION_CONFLICT_ACTIONS = frozenset(
         "restart",
         "rename",
         "error",
+        "skip",
         "mergeOverwrite",
         "mergeSkip",
     }
@@ -99,21 +104,21 @@ def _build_launch_plan(
 def _existing_conflict_hint(backend: SessionBackend) -> str:
     if backend in MERGE_NEW_WINDOWS_SUPPORTED_BACKENDS:
         return (
-            "Use --on-conflict restart, --on-conflict rename, "
+            "Use --on-conflict restart, --on-conflict rename, --on-conflict skip, "
             "--on-conflict mergeOverwrite, or "
             "--on-conflict mergeSkip."
         )
-    return "Use --on-conflict restart or --on-conflict rename."
+    return "Use --on-conflict restart, --on-conflict rename, or --on-conflict skip."
 
 
 def _duplicate_conflict_hint(backend: SessionBackend) -> str:
     if backend in MERGE_NEW_WINDOWS_SUPPORTED_BACKENDS:
         return (
-            "Use unique layout names, --on-conflict rename, "
+            "Use unique layout names, --on-conflict rename, --on-conflict skip, "
             "--on-conflict mergeOverwrite, or "
             "--on-conflict mergeSkip."
         )
-    return "Use unique layout names or --on-conflict rename."
+    return "Use unique layout names, --on-conflict rename, or --on-conflict skip."
 
 
 def list_existing_sessions(backend: SessionBackend) -> set[str]:
@@ -133,24 +138,6 @@ def list_existing_sessions(backend: SessionBackend) -> set[str]:
                 return set()
             return {line.strip() for line in result.stdout.splitlines() if line.strip()}
 
-        if backend == "zellij":
-            result = subprocess.run(
-                ["zellij", "list-sessions"],
-                capture_output=True,
-                text=True,
-                timeout=10,
-                check=False,
-            )
-            if result.returncode != 0:
-                return set()
-            sessions: set[str] = set()
-            for line in result.stdout.splitlines():
-                cleaned = line.strip()
-                if not cleaned:
-                    continue
-                sessions.add(cleaned.split()[0])
-            return sessions
-
         if backend == "windows-terminal":
             from stackops.cluster.sessions_managers.windows_terminal.wt_utils.wt_helpers import POWERSHELL_CMD
 
@@ -265,6 +252,18 @@ def build_session_launch_plan(
                 )
                 planned_sessions.add(requested_name)
                 continue
+            case "skip":
+                if conflict_with_existing or conflict_with_planned:
+                    plans.append(
+                        _build_launch_plan(
+                            requested_name=requested_name,
+                            session_name=requested_name,
+                            restart_required=False,
+                            conflict_source=conflict_source,
+                            skip_launch=True,
+                        )
+                    )
+                    continue
             case "error":
                 if conflict_with_planned:
                     raise SessionConflictError(
@@ -343,16 +342,6 @@ def kill_existing_session(backend: SessionBackend, session_name: str) -> None:
             )
             return
 
-        if backend == "zellij":
-            subprocess.run(
-                ["zellij", "delete-session", "--force", session_name],
-                capture_output=True,
-                text=True,
-                timeout=10,
-                check=False,
-            )
-            return
-
         if backend == "windows-terminal":
             from stackops.cluster.sessions_managers.windows_terminal.wt_utils.wt_helpers import POWERSHELL_CMD
 

{stackops-26.6.3 → stackops-26.6.4}/src/stackops/cluster/sessions_managers/tmux/tmux_local.py

@@ -27,7 +27,7 @@ from stackops.cluster.sessions_managers.tmux.tmux_utils.tmux_layout import (
     build_tmux_script_from_commands,
     validate_layout_config,
 )
-from stackops.cluster.sessions_managers.zellij.zellij_utils.monitoring_types import CommandStatus
+from stackops.cluster.sessions_managers.monitoring_types import CommandStatus
 
 
 console = Console()
@@ -195,7 +195,13 @@ class TmuxLayoutGenerator:
         self,
         launch_plan: SessionLaunchPlan,
         on_conflict: SessionConflictAction,
-    ) -> None:
+    ) -> bool:
+        if launch_plan.get("skip_launch", False):
+            console.print(
+                f"[bold cyan]⏭️ Skipping tmux session[/bold cyan] [cyan]'{launch_plan['session_name']}'[/cyan]"
+            )
+            self.launch_commands = []
+            return False
         if launch_plan["session_name"] != self.session_name:
             console.print(
                 f"[bold yellow]📝 Renaming tmux session[/bold yellow] [yellow]'{self.session_name}'[/yellow] "
@@ -208,13 +214,16 @@ class TmuxLayoutGenerator:
             )
             kill_existing_session("tmux", self.session_name)
         self.prepare_launch_script(on_conflict=on_conflict)
+        return True
 
     def run(self, on_conflict: SessionConflictAction) -> dict[str, str | int]:
         launch_plan = build_session_launch_plan([self.session_name], backend="tmux", on_conflict=on_conflict)[0]
-        self.apply_launch_plan(
+        should_launch = self.apply_launch_plan(
             launch_plan=launch_plan,
             on_conflict=on_conflict,
         )
+        if not should_launch:
+            return {"returncode": 0, "stdout": "", "stderr": ""}
         if len(self.launch_commands) == 0:
             raise RuntimeError("tmux launch commands were not prepared")
         run_tmux_commands(

{stackops-26.6.3 → stackops-26.6.4}/src/stackops/cluster/sessions_managers/tmux/tmux_local_manager.py

@@ -21,7 +21,7 @@ from stackops.cluster.sessions_managers.tmux.tmux_utils.tmux_status import (
     build_unknown_command_status,
     check_tmux_session_status,
 )
-from stackops.cluster.sessions_managers.zellij.zellij_utils.monitoring_types import StartResult, CommandStatus
+from stackops.cluster.sessions_managers.monitoring_types import CommandStatus, StartResult
 from stackops.cluster.sessions_managers.windows_terminal.wt_utils.status_reporting import calculate_global_summary_from_status
 
 
@@ -73,6 +73,12 @@ class TmuxLocalManager:
         for manager, plan in zip(self.managers, launch_plan, strict=True):
             original_session_name = manager.session_name or "unknown"
             session_name = original_session_name
+            if plan.get("skip_launch", False):
+                results[session_name] = {
+                    "success": True,
+                    "message": f"Skipped existing session '{session_name}'",
+                }
+                continue
             try:
                 manager.apply_launch_plan(
                     launch_plan=plan,

{stackops-26.6.3 → stackops-26.6.4}/src/stackops/cluster/sessions_managers/tmux/tmux_utils/tmux_status.py

@@ -2,7 +2,7 @@
 import subprocess
 from typing import NotRequired, TypedDict
 
-from stackops.cluster.sessions_managers.zellij.zellij_utils.monitoring_types import CommandStatus
+from stackops.cluster.sessions_managers.monitoring_types import CommandStatus
 from stackops.utils.schemas.layouts.layout_types import TabConfig
 
 
@@ -73,4 +73,4 @@ def build_unknown_command_status(tab_config: TabConfig) -> CommandStatus:
         "command": tab_config["command"],
         "tab_name": tab_config["tabName"],
         "cwd": tab_config["startDir"],
-    }
+    }

{stackops-26.6.3 → stackops-26.6.4}/src/stackops/cluster/sessions_managers/utils/load_balancer.py

@@ -48,9 +48,9 @@ def limit_tab_weight(layout_configs: list[LayoutConfig], max_weight: int, comman
     return new_layout_configs
 
 
-def run(layouts: list[LayoutConfig], on_conflict: SessionConflictAction):
-    from stackops.cluster.sessions_managers.zellij.zellij_local_manager import ZellijLocalManager
-    manager = ZellijLocalManager(session_layouts=layouts)
-    manager.start_all_sessions(on_conflict=on_conflict, poll_interval=2, poll_seconds=2)
+def run(layouts: list[LayoutConfig], on_conflict: SessionConflictAction) -> None:
+    from stackops.cluster.sessions_managers.tmux.tmux_local_manager import TmuxLocalManager
+    manager = TmuxLocalManager(session_layouts=layouts, session_name_prefix=None, exit_mode="backToShell")
+    manager.start_all_sessions(on_conflict=on_conflict)
     manager.run_monitoring_routine(wait_ms=2000)
     manager.kill_all_sessions()

{stackops-26.6.3 → stackops-26.6.4}/src/stackops/cluster/sessions_managers/windows_terminal/wt_local.py

@@ -1,7 +1,6 @@
 #!/usr/bin/env python3
 """
 Windows Terminal local layout generator and session manager.
-Equivalent to zellij_local.py but for Windows Terminal.
 
 """
 

{stackops-26.6.3 → stackops-26.6.4}/src/stackops/cluster/sessions_managers/windows_terminal/wt_local_manager.py

@@ -12,7 +12,7 @@ from stackops.cluster.scheduler import Scheduler, LoggerTemplate
 from stackops.cluster.sessions_managers.windows_terminal.wt_local import WTLayoutGenerator
 from stackops.cluster.sessions_managers.windows_terminal.wt_utils.wt_helpers import check_wt_session_status
 from stackops.utils.schemas.layouts.layout_types import LayoutConfig
-from stackops.cluster.sessions_managers.zellij.zellij_utils.monitoring_types import StartResult, ActiveSessionInfo
+from stackops.cluster.sessions_managers.monitoring_types import ActiveSessionInfo, StartResult
 from stackops.cluster.sessions_managers.windows_terminal.wt_utils.manager_persistence import (
     generate_session_id, save_json_file, load_json_file, list_saved_sessions_in_dir, delete_session_dir, ensure_session_dir_exists
 )

{stackops-26.6.3 → stackops-26.6.4}/src/stackops/cluster/sessions_managers/windows_terminal/wt_utils/process_monitor.py

@@ -1,7 +1,6 @@
 #!/usr/bin/env python3
 """
 Process monitoring and status checking utilities for Windows Terminal commands.
-Adapted from zellij process monitor but focused on Windows processes.
 """
 
 import json

{stackops-26.6.3 → stackops-26.6.4}/src/stackops/cluster/sessions_managers/windows_terminal/wt_utils/remote_executor.py

@@ -1,7 +1,6 @@
 #!/usr/bin/env python3
 """
 Remote command execution utilities for SSH operations with Windows Terminal.
-Adapted from zellij remote executor but focused on Windows Terminal commands.
 """
 
 import subprocess

{stackops-26.6.3 → stackops-26.6.4}/src/stackops/jobs/installer/checks/security_helper.py

@@ -4,8 +4,6 @@ from pathlib import Path
 from collections.abc import Mapping, Sequence
 from typing import TYPE_CHECKING, Literal
 
-from stackops.jobs.installer.checks.vt_utils import summarize_scan_results
-
 if TYPE_CHECKING:
     from rich.table import Table
 
@@ -118,6 +116,8 @@ def _build_empty_app_data(app_row: AppMetadataRow) -> AppData:
 
 
 def build_app_data_list(app_rows: Sequence[AppMetadataRow], engine_rows: Sequence[StoredEngineReportRow]) -> list[AppData]:
+    from stackops.jobs.installer.checks.vt_utils import summarize_scan_results
+
     engine_rows_by_app: dict[str, list[StoredEngineReportRow]] = {}
     for engine_row in engine_rows:
         engine_rows_by_app.setdefault(engine_row["app_name"], []).append(engine_row)

{stackops-26.6.3 → stackops-26.6.4}/src/stackops/scripts/python/agents.py

@@ -1,19 +1,18 @@
 """Agents management commands - lazy loading subcommands."""
 
 from pathlib import Path
-import shlex
 from typing import Annotated, Final, Literal, TypeAlias, cast, get_args
 
 import typer
 
-from stackops.scripts.python.agents_browser import get_app as get_browser_app
-from stackops.scripts.python.agents_parallel import get_app as get_parallel_app
-from stackops.scripts.python.helpers.helpers_agents.agents_run_context import PROMPTS_SOURCE
-from stackops.utils.schemas.fire_agents.fire_agents_types import AGENTS
-from stackops.scripts.python.helpers.helpers_agents.mcp_install import MCP_INSTALL_SCOPE
 from stackops.scripts.python.helpers.helpers_agents.mcp_types import MCP_CATALOG_SOURCE
-from stackops.scripts.python.helpers.helpers_agents.agents_skill_impl import SKILL_INSTALL_SCOPE
 from stackops.scripts.python.helpers.helpers_agents.reasoning_capabilities import ReasoningEffort, ReasoningShortcut
+from stackops.utils.schemas.fire_agents.fire_agents_types import AGENTS
+
+_MCP_INSTALL_SCOPE: TypeAlias = Literal["local", "global"]
+_PROMPTS_SOURCE: TypeAlias = Literal["all", "a", "repo", "r", "private", "p", "public", "b", "library", "l"]
+_SKILL_INSTALL_SCOPE: TypeAlias = Literal["local", "global"]
+_SKILL_INSTALL_BACKEND: TypeAlias = Literal["bunx", "npx"]
 
 _ASK_REASONING_HELP: Final[str] = "n=none, l=low, m=medium, h=high, x=xhigh; supported for codex, copilot, and pi"
 _AGENT_VALUES: Final[tuple[AGENTS, ...]] = cast(tuple[AGENTS, ...], get_args(AGENTS))
@@ -108,7 +107,7 @@ def add_mcp(
         str, typer.Option("--agent", "-a", help=f"AI agents to configure (comma-separated), default is all of them. {','.join(get_args(AGENTS))}")
     ] = "",
     scope: Annotated[
-        MCP_INSTALL_SCOPE, typer.Option("--scope", "-s", help="Install MCP config or skill files into repo-local or user-global agent config.")
+        _MCP_INSTALL_SCOPE, typer.Option("--scope", "-s", help="Install MCP config or skill files into repo-local or user-global agent config.")
     ] = "local",
     source: Annotated[MCP_CATALOG_SOURCE, typer.Option(..., "--source", "-S", help="Source to resolve or edit MCP catalog files.")] = "all",
     edit: Annotated[
@@ -222,6 +221,8 @@ def run_interactive(
     ] = False,
 ) -> None:
     """Launch an agent with reasonable defaults."""
+    import shlex
+
     resolved_agent = _resolve_interactive_agent(agent=agent)
     command = _apply_overhead(command=_interactive_agent_command(agent=resolved_agent, caveman=caveman), overhead=overhead)
     from stackops.utils.code import exit_then_run_shell_script
@@ -264,7 +265,7 @@ def run_prompt(
         ),
     ] = None,
     source: Annotated[
-        PROMPTS_SOURCE,
+        _PROMPTS_SOURCE,
         typer.Option(..., "--source", "-s", help="Source to look for context YAML files when --context-yaml-path is not provided."),
     ] = "all",
     show_prompts_yaml_format: Annotated[
@@ -337,24 +338,31 @@ def add_skill(
         ),
     ] = None,
     scope: Annotated[
-        SKILL_INSTALL_SCOPE, typer.Option("--scope", "-s", help="Install the skill into the repo-local or user-global agent skill directory.")
+        _SKILL_INSTALL_SCOPE, typer.Option("--scope", "-s", help="Install the skill into the repo-local or user-global agent skill directory.")
     ] = "local",
     directory: Annotated[
         str | None,
         typer.Option(..., "--directory", "-d", help="Directory to add the skill to. If not provided, defaults to current working directory."),
     ] = None,
+    backend: Annotated[
+        _SKILL_INSTALL_BACKEND,
+        typer.Option("--backend", "-b", help="Package runner backend for the upstream skills CLI."),
+    ] = "bunx",
 ) -> None:
     """Add a skill through the upstream skills CLI."""
     try:
         from stackops.scripts.python.helpers.helpers_agents.agents_skill_impl import add_skill as impl
 
-        return_code = impl(skill_name=skill_name, agent=agent, scope=scope, directory=directory)
+        return_code = impl(skill_name=skill_name, agent=agent, scope=scope, directory=directory, backend=backend)
     except ValueError as error:
         raise typer.BadParameter(str(error)) from error
     raise typer.Exit(code=return_code)
 
 
 def get_app() -> typer.Typer:
+    from stackops.scripts.python.agents_browser import get_app as get_browser_app
+    from stackops.scripts.python.agents_parallel import get_app as get_parallel_app
+
     agents_app = typer.Typer(help="🤖 AI Agents management subcommands", no_args_is_help=True, add_help_option=True, add_completion=False)
     agents_app.add_typer(
         get_parallel_app(), name="parallel", help="🧵 <p> Parallel agent workflow commands", short_help="<p> Parallel agent workflow commands"

{stackops-26.6.3 → stackops-26.6.4}/src/stackops/scripts/python/agents_parallel.py

@@ -4,12 +4,12 @@ from typing import get_args
 
 import typer
 
-from stackops.scripts.python.agents_parallel_commands import agents_create, collect, create_context, make_agents_command_template
-from stackops.scripts.python.agents_parallel_run_command import run_parallel
-from stackops.utils.schemas.fire_agents.fire_agents_types import AGENTS, PROVIDER
-
 
 def get_app() -> typer.Typer:
+    from stackops.scripts.python.agents_parallel_commands import agents_create, collect, create_context, make_agents_command_template
+    from stackops.scripts.python.agents_parallel_run_command import run_parallel
+    from stackops.utils.schemas.fire_agents.fire_agents_types import AGENTS, PROVIDER
+
     parallel_app = typer.Typer(
         help="🧵 <p> Parallel agent workflow commands",
         no_args_is_help=True,

{stackops-26.6.3 → stackops-26.6.4}/src/stackops/scripts/python/agents_parallel_run_command.py

@@ -1,12 +1,13 @@
 """Run-parallel command wrapper."""
 
-from typing import Annotated, get_args
+from typing import Annotated, Literal, get_args
 
 import typer
 
-from stackops.scripts.python.helpers.helpers_agents.agents_parallel_run_config import PARALLEL_RUNS_SOURCE, ParallelCreateValues
-from stackops.utils.schemas.fire_agents.fire_agents_types import AGENTS, HOST, PROVIDER
 from stackops.scripts.python.helpers.helpers_agents.reasoning_capabilities import ReasoningEffort
+from stackops.utils.schemas.fire_agents.fire_agents_types import AGENTS, HOST, PROVIDER
+
+_PARALLEL_RUNS_SOURCE = Literal["all", "a", "repo", "r", "private", "p", "public", "b", "library", "l"]
 
 
 def run_parallel(
@@ -15,7 +16,7 @@ def run_parallel(
         str | None, typer.Option(..., "--yaml-path", "-y", help="YAML file containing named parallel runs. Auto-created with a template if missing.")
     ] = None,
     source: Annotated[
-        PARALLEL_RUNS_SOURCE,
+        _PARALLEL_RUNS_SOURCE,
         typer.Option(..., "--source", "-S", help="Source to look for parallel YAML files when --yaml-path is not provided."),
     ] = "all",
     show_parallel_yaml_format: Annotated[
@@ -72,6 +73,7 @@ def run_parallel(
     ] = None,
 ) -> None:
     """Run a named parallel agent workflow from YAML, with create-option overrides."""
+    from stackops.scripts.python.helpers.helpers_agents.agents_parallel_run_config import ParallelCreateValues
     from stackops.scripts.python.helpers.helpers_agents.agents_parallel_run_impl import run_parallel_from_yaml
 
     try: