machineconfig 6.86__py3-none-any.whl → 6.88__py3-none-any.whl

machineconfig/jobs/installer/installer_data.json

@@ -208,7 +208,7 @@
     {
       "appName": "croc",
       "repoURL": "https://github.com/schollz/croc",
-      "doc": "🦎 Easily and securely send things from one computer to another",
+      "doc": "🦎 Easily and securely send and share things from one computer to another",
       "fileNamePattern": {
         "amd64": {
           "linux": "croc_{version}_Linux-64bit.tar.gz",
@@ -273,6 +273,23 @@
         }
       }
     },
+    {
+      "appName": "asciinema",
+      "repoURL": "https://github.com/asciinema/asciinema",
+      "doc": "🎥 Terminal session recorder",
+      "fileNamePattern": {
+        "amd64": {
+          "linux": "asciinema-x86_64-unknown-linux-gnu",
+          "windows": null,
+          "macos": "asciinema-x86_64-apple-darwin"
+        },
+        "arm64": {
+          "linux": null,
+          "windows": null,
+          "macos": null
+        }
+      }
+    },
     {
       "appName": "lolcatjs",
       "repoURL": "CMD",

machineconfig/scripts/linux/mcfgs

@@ -1,39 +1,48 @@
 #!/usr/bin/env bash
-set -euo pipefail
-
-RANDOM_NAME=$(date +%s%N | sha256sum | head -c 16)
-OP_DIR="$HOME/tmp_results/tmp_scripts/machineconfig"
-OP_PROGRAM_PATH="$OP_DIR/${RANDOM_NAME}.sh"
-export OP_PROGRAM_PATH
-
-# ANSI color/style codes
-BOLD="\033[1m"
-RESET="\033[0m"
-GREEN="\033[32m"
-YELLOW="\033[33m"
-BLUE="\033[34m"
-RED="\033[31m"
-
-timestamp=$(date -u +"%Y-%m-%d %H:%M:%SZ")
-
-printf "%b\n" "${BOLD}${BLUE}🛠️  machineconfig — running mcfg${RESET}"
-printf "%b\n" "${BLUE}Timestamp:${RESET} ${timestamp}"
-printf "%b\n" "${BLUE}Op program path:${RESET} ${OP_PROGRAM_PATH}"
-
-# Forward arguments to the mcfg command
-mcfg "$@"
-
-if [[ -f "$OP_PROGRAM_PATH" ]]; then
-  printf "%b\n" "${GREEN}✅ Found op program:${RESET} ${OP_PROGRAM_PATH}"
-  bat --style=plain --paging=never "$OP_PROGRAM_PATH"
-  printf "%b\n" "${GREEN}▶ Running...${RESET}"
-  . "$OP_PROGRAM_PATH"
-  status=$?
-  if [[ $status -eq 0 ]]; then
-    printf "%b\n" "${GREEN}✅ Completed successfully (exit ${status})${RESET}"
+
+
+wrap_in_op_program() {
+  # set -euo pipefail
+
+  # ANSI color/style codes
+  BOLD="\033[1m"
+  RESET="\033[0m"
+  GREEN="\033[32m"
+  YELLOW="\033[33m"
+  BLUE="\033[34m"
+  RED="\033[31m"
+
+  local command="$1"
+  shift  
+  local RANDOM_NAME=$(date +%s%N | sha256sum | head -c 16)
+  local OP_DIR="$HOME/tmp_results/tmp_scripts/machineconfig"
+  local OP_PROGRAM_PATH="$OP_DIR/${RANDOM_NAME}.sh"
+  export OP_PROGRAM_PATH
+  local timestamp=$(date -u +"%Y-%m-%d %H:%M:%SZ")
+  printf "%b\n" "${BOLD}${BLUE}🛠️  machineconfig — running ${command}${RESET}"
+  printf "%b\n" "${BLUE}Timestamp:${RESET} ${timestamp}"
+  printf "%b\n" "${BLUE}Op program path:${RESET} ${OP_PROGRAM_PATH}"
+
+  # Forward arguments to the command
+  "$command" "$@"
+
+  if [[ -f "$OP_PROGRAM_PATH" ]]; then
+    printf "%b\n" "${GREEN}✅ Found op program:${RESET} ${OP_PROGRAM_PATH}"
+    bat --style=plain --paging=never "$OP_PROGRAM_PATH"
+    printf "%b\n" "${GREEN}▶ Running...${RESET}"
+    . "$OP_PROGRAM_PATH"
+    status=$?
+    if [[ $status -eq 0 ]]; then
+      printf "%b\n" "${GREEN}✅ Completed successfully (exit ${status})${RESET}"
+    else
+      printf "%b\n" "${YELLOW}⚠️  Program exited with status ${status}${RESET}"
+    fi
   else
-    printf "%b\n" "${YELLOW}⚠️  Program exited with status ${status}${RESET}"
+    printf "%b\n" "${YELLOW}⚠️  No op program found at: ${OP_PROGRAM_PATH}${RESET}"
   fi
-else
-  printf "%b\n" "${YELLOW}⚠️  No op program found at: ${OP_PROGRAM_PATH}${RESET}"
+}
+
+if [[ $# -gt 0 ]]; then
+  wrap_in_op_program "$@"
 fi
+

machineconfig/scripts/python/agents.py

@@ -5,13 +5,13 @@
 from pathlib import Path
 from typing import cast, Optional, get_args, Annotated
 import typer
-from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import AGENTS, HOST, MODEL, PROVIDER
+from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import AGENTS, HOST, PROVIDER
 
 
 def create(
     agent: Annotated[AGENTS, typer.Option(..., "--agents", "-a", help=f"Agent type. One of {', '.join(get_args(AGENTS)[:3])}")],
     host: Annotated[HOST, typer.Option(..., "--host", "-h", help=f"Machine to run agents on. One of {', '.join(get_args(HOST))}")],
-    model: Annotated[MODEL, typer.Option(..., "--model", "-m", help=f"Model to use (for crush agent). One of {', '.join(get_args(MODEL)[:3])}")],
+    model: Annotated[str, typer.Option(..., "--model", "-m", help="Model to use (for crush agent).")],
     provider: Annotated[PROVIDER, typer.Option(..., "--provider", "-p", help=f"Provider to use (for crush agent). One of {', '.join(get_args(PROVIDER)[:3])}")],
     context_path: Annotated[Optional[Path], typer.Option(..., "--context-path", "-c", help="Path to the context file/folder, defaults to .ai/todo/")] = None,
     separator: Annotated[str, typer.Option(..., "--separator", "-s", help="Separator for context")] = "\n",
@@ -26,20 +26,9 @@ def create(
 
     from machineconfig.scripts.python.helpers_agents.fire_agents_help_launch import prep_agent_launch, get_agents_launch_layout
     from machineconfig.scripts.python.helpers_agents.fire_agents_load_balancer import chunk_prompts
-    from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import PROVIDER2MODEL
     from machineconfig.utils.accessories import get_repo_root, randstr
     import json
 
-    # validate model is valid for the provider
-    valid_models_for_provider = PROVIDER2MODEL.get(provider, [])
-    if model not in valid_models_for_provider:
-        available_models = "\n  ".join(valid_models_for_provider) if valid_models_for_provider else "(none configured)"
-        raise typer.BadParameter(
-            f"Model '{model}' is not valid for provider '{provider}'.\n"
-            f"Valid models for '{provider}':\n  {available_models}\n"
-            f"All available models: {', '.join(get_args(MODEL))}"
-        )
-
     # validate mutual exclusive
     prompt_options = [prompt, prompt_path]
     provided_prompt = [opt for opt in prompt_options if opt is not None]
@@ -179,8 +168,6 @@ def get_app():
 PROVIDER options: {', '.join(get_args(PROVIDER))}
 {sep}
 AGENT options: {', '.join(get_args(AGENTS))}
-{sep}
-MODEL options: {sep.join(get_args(MODEL))}
 """
     agents_app.command("create", no_args_is_help=True, help=agents_full_help)(create)
     agents_app.command("c", no_args_is_help=True, help="Create agents layout file, ready to run.", hidden=True)(create)

machineconfig/scripts/python/env_manager/path_manager_tui.py

@@ -2,7 +2,7 @@
 # /// script
 # requires-python = ">=3.13"
 # dependencies = [
-#     "machineconfig>=6.86",
+#     "machineconfig>=6.88",
 #     "textual",
 #     "pyperclip",
 # ]

machineconfig/scripts/python/fire_jobs.py

@@ -35,7 +35,6 @@ def route(args: FireJobArgs, fire_args: str = "") -> None:
     else:
         choice_file = path_obj
 
-
     repo_root = get_repo_root(Path(choice_file))
     print(f"💾 Selected file: {choice_file}.\nRepo root: {repo_root}")
     if args.marimo:
@@ -67,18 +66,19 @@ uv run --project {repo_root} --with marimo marimo edit --host 0.0.0.0 marimo_nb.
 
     if choice_file.suffix == ".py":
         from machineconfig.scripts.python.helpers_fire_command.fire_jobs_route_helper import get_command_streamlit
+        with_project = f"--project {repo_root} " if repo_root is not None else ""
         if args.streamlit:
             exe = get_command_streamlit(choice_file=choice_file, environment=args.environment, repo_root=repo_root)
-            exe = f"uv run {exe} "
-        elif args.jupyter: exe = "uv run jupyter-lab"
+            exe = f"uv run {with_project} {exe} "
+        elif args.jupyter: exe = f"uv run {with_project} jupyter-lab"
         else:
             if args.interactive:
                 _ve_root_from_file, ipy_profile = get_ve_path_and_ipython_profile(choice_file)
                 if ipy_profile is None:
                     ipy_profile = "default"
-                exe = f"uv run ipython -i --no-banner --profile {ipy_profile} "
+                exe = f"uv run {with_project} ipython -i --no-banner --profile {ipy_profile} "
             else:
-                exe = "uv run python "
+                exe = f"uv run {with_project} python "
     elif choice_file.suffix == ".ps1" or choice_file.suffix == ".sh": exe = "."
     elif choice_file.suffix == "": exe = ""
     else: raise NotImplementedError(f"File type {choice_file.suffix} not supported, in the sense that I don't know how to fire it.")
@@ -155,12 +155,8 @@ uv run --project {repo_root} --with marimo marimo edit --host 0.0.0.0 marimo_nb.
     if args.git_pull:
         command = f"\ngit -C {choice_file.parent} pull\n" + command
     if args.PathExport:
-        if platform.system() in ["Linux", "Darwin"]:
-            export_line = f"""export PYTHONPATH="{repo_root}""" + """:${PYTHONPATH}" """
-        elif platform.system() == "Windows":
-            export_line = f"""$env:PYTHONPATH="{repo_root}""" + """:$env:PYTHONPATH" """
-        else:
-            raise NotImplementedError(f"Platform {platform.system()} not supported.")
+        from machineconfig.scripts.python.helpers_fire_command.file_wrangler import add_to_path
+        export_line = add_to_path(path_variable="PYTHONPATH", directory=str(repo_root))
         command = export_line + "\n" + command
     if args.loop:
         if platform.system() in ["Linux", "Darwin"]:

machineconfig/scripts/python/helpers_agents/agentic_frameworks/fire_crush.py

@@ -1,21 +1,20 @@
 
 from pathlib import Path
 # import shlex
-from typing import Optional
-from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import HOST, PROVIDER, MODEL
+from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import AI_SPEC
 
 
-def fire_crush(api_key: Optional[str], model: MODEL, provider: PROVIDER, machine: HOST, prompt_path: Path, repo_root: Path) -> str:
-    match machine:
+def fire_crush(ai_spec: AI_SPEC, prompt_path: Path, repo_root: Path) -> str:
+    match ai_spec["machine"]:
         case "local":
             cmd = f"""
 crush run {prompt_path}
 """
         case "docker":
-            assert api_key is not None, "API key is required for Crush agent in docker mode."
+            assert ai_spec["api_key"] is not None, "API key is required for Crush agent in docker mode."
             json_path = Path(__file__).parent / "fire_crush.json"
             json_template = json_path.read_text(encoding="utf-8")
-            json_filled = json_template.replace("{api_key}", api_key).replace("{model}", model).replace("{provider}", provider)
+            json_filled = json_template.replace("{api_key}", ai_spec["api_key"]).replace("{model}", ai_spec["model"]).replace("{provider}", ai_spec["provider"])
             from machineconfig.utils.accessories import randstr
             temp_config_file_local = Path.home().joinpath("tmp_results/tmp_files/crush_" + randstr(8) + ".json")
             temp_config_file_local.parent.mkdir(parents=True, exist_ok=True)
@@ -23,7 +22,7 @@ crush run {prompt_path}
             cmd = f"""
 
 #   -e "PATH_PROMPT=$PATH_PROMPT"
-#   opencode --model "{provider}/{model}" run {prompt_path}
+#   opencode --model "{ai_spec["provider"]}/{ai_spec["model"]}" run {prompt_path}
   
 
 echo "Running prompt @ {prompt_path.relative_to(repo_root)} using Docker with Crush..."

machineconfig/scripts/python/helpers_agents/agentic_frameworks/fire_cursor_agents.py

@@ -2,11 +2,10 @@
 
 from pathlib import Path
 # import shlex
-from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import HOST
-from typing import Optional
+from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import AI_SPEC
 
-def fire_cursor(api_key: Optional[str], prompt_path: Path, machine: HOST) -> str:
-    match machine:
+def fire_cursor(ai_spec: AI_SPEC, prompt_path: Path) -> str:
+    match ai_spec["machine"]:
         case "local":
             # Export the environment variable so it's available to subshells
             cmd = f"""

machineconfig/scripts/python/helpers_agents/agentic_frameworks/fire_gemini.py

@@ -1,26 +1,25 @@
 
 from pathlib import Path
 import shlex
-from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import HOST
-from typing import Optional, Literal
+from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import AI_SPEC
 
 
-def fire_gemini(api_key: Optional[str], model: Literal["gemini-2.5-pro"], provider: Literal["google"], machine: HOST, prompt_path: Path, repo_root: Path) -> str:
-    _ = provider
+def fire_gemini(ai_spec: AI_SPEC, prompt_path: Path, repo_root: Path) -> str:
+    _ = ai_spec["provider"]
     # model = "gemini-2.5-flash-lite"
     # model = None  # auto-select
     # if model is None:
     #     model_arg = ""
     # else:
-    model_arg = f"--model {shlex.quote(model)}"
+    model_arg = f"--model {shlex.quote(ai_spec['model'])}"
     # Need a real shell for the pipeline; otherwise '| gemini ...' is passed as args to 'cat'
     safe_path = shlex.quote(str(prompt_path))
 
-    match machine:
+    match ai_spec["machine"]:
         case "local":
             # Export the environment variable so it's available to subshells
-            if api_key is not None:
-                define_api_key = f"""export GEMINI_API_KEY="{shlex.quote(api_key)}" """
+            if ai_spec["api_key"] is not None:
+                define_api_key = f"""export GEMINI_API_KEY="{shlex.quote(ai_spec['api_key'])}" """
             else:
                 define_api_key = "echo 'Warning: No GEMINI_API_KEY provided, hoping it is set in the environment.'"
             cmd = f"""
@@ -31,10 +30,10 @@ gemini {model_arg} --yolo --prompt {safe_path}
             
 
         case "docker":
-            assert api_key is not None, "When using docker, api_key must be provided."
+            assert ai_spec["api_key"] is not None, "When using docker, api_key must be provided."
             cmd = f"""
 docker run -it --rm \
-  -e GEMINI_API_KEY="{api_key}" \
+  -e GEMINI_API_KEY="{ai_spec['api_key']}" \
   -v "{repo_root}:/workspace/{repo_root.name}" \
   -w "/workspace/{repo_root.name}" \
   statistician/machineconfig-ai:latest  \

machineconfig/scripts/python/helpers_agents/agentic_frameworks/fire_qwen.py

@@ -1,11 +1,10 @@
 
 from pathlib import Path
 import shlex
-from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import HOST
-from typing import Optional, Literal
+from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import AI_SPEC
 
 
-def fire_qwen(config_dir: Optional[str], model: Literal["qwen"], provider: Literal["qwen"], machine: HOST, prompt_path: Path, repo_root: Path) -> str:
+def fire_qwen(ai_spec: AI_SPEC, prompt_path: Path, repo_root: Path, config_dir: str | None) -> str:
     # assert model == "qwen", "Only qwen is supported currently."
     # assert provider == "qwen", "Only qwen is supported currently."
     # model = "qwen"
@@ -14,12 +13,12 @@ def fire_qwen(config_dir: Optional[str], model: Literal["qwen"], provider: Liter
     # if model is None:
     #     model_arg = ""
     # else:
-    _ = provider
+    _ = ai_spec["provider"]
     # model_arg = f"--model {shlex.quote(model)}"
     # Need a real shell for the pipeline; otherwise '| gemini ...' is passed as args to 'cat'
     safe_path = shlex.quote(str(prompt_path))
 
-    match machine:
+    match ai_spec["machine"]:
         case "local":
             # Export the environment variable so it's available to subshells
             cmd = f"""

machineconfig/scripts/python/helpers_agents/fire_agents_help_launch.py

@@ -2,7 +2,7 @@
 import random
 import shlex
 from pathlib import Path
-from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import AGENTS, AGENT_NAME_FORMATTER, HOST, PROVIDER, MODEL
+from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import AGENTS, AGENT_NAME_FORMATTER, HOST, PROVIDER, AI_SPEC
 
 
 def get_api_keys(provider: PROVIDER) -> list[str]:
@@ -20,7 +20,7 @@ def get_api_keys(provider: PROVIDER) -> list[str]:
 
 
 def prep_agent_launch(repo_root: Path, agents_dir: Path, prompts_material: list[str], prompt_prefix: str, keep_material_in_separate_file: bool,
-                      machine: HOST, model: MODEL, provider: PROVIDER, agent: AGENTS, *, job_name: str) -> None:
+                      machine: HOST, model: str, provider: PROVIDER, agent: AGENTS, *, job_name: str) -> None:
     agents_dir.mkdir(parents=True, exist_ok=True)
     prompt_folder = agents_dir / "prompts"
     prompt_folder.mkdir(parents=True, exist_ok=True)
@@ -66,17 +66,20 @@ sleep 0.1
                 assert provider == "google", "Gemini agent only works with google provider."
                 api_keys = get_api_keys(provider="google")
                 api_key = api_keys[idx % len(api_keys)] if len(api_keys) > 0 else None
+                ai_spec: AI_SPEC = AI_SPEC(provider=provider, model="gemini-2.5-pro", agent=agent, machine=machine, api_key=api_key, api_name="gemini")
                 from machineconfig.scripts.python.helpers_agents.agentic_frameworks.fire_gemini import fire_gemini
-                cmd = fire_gemini(api_key=api_key, prompt_path=prompt_path, machine=machine, model="gemini-2.5-pro", provider="google", repo_root=repo_root)
+                cmd = fire_gemini(ai_spec=ai_spec, prompt_path=prompt_path, repo_root=repo_root)
             case "cursor-agent":
+                ai_spec: AI_SPEC = AI_SPEC(provider=provider, model=model, agent=agent, machine=machine, api_key=None, api_name="cursor")
                 from machineconfig.scripts.python.helpers_agents.agentic_frameworks.fire_cursor_agents import fire_cursor
-                cmd = fire_cursor(prompt_path=prompt_path, machine=machine, api_key=None)
+                cmd = fire_cursor(ai_spec=ai_spec, prompt_path=prompt_path)
                 raise NotImplementedError("Cursor agent is not implemented yet, api key missing")
             case "crush":
-                from machineconfig.scripts.python.helpers_agents.agentic_frameworks.fire_crush import fire_crush
                 api_keys = get_api_keys(provider=provider)
                 api_key = api_keys[idx % len(api_keys)] if len(api_keys) > 0 else None
-                cmd = fire_crush(api_key=api_key, prompt_path=prompt_path, machine=machine, repo_root=repo_root, model=model, provider=provider)
+                ai_spec: AI_SPEC = AI_SPEC(provider=provider, model=model, agent=agent, machine=machine, api_key=api_key, api_name="crush")
+                from machineconfig.scripts.python.helpers_agents.agentic_frameworks.fire_crush import fire_crush
+                cmd = fire_crush(ai_spec=ai_spec, prompt_path=prompt_path, repo_root=repo_root)
             # case "q":
             #     from machineconfig.scripts.python.helpers_fire.fire_q import fire_q
             #     cmd = fire_q(api_key="", prompt_path=prompt_path, machine=machine)

machineconfig/scripts/python/helpers_agents/fire_agents_helper_types.py

@@ -19,24 +19,14 @@ from typing import Literal, TypeAlias, TypedDict
 AGENTS: TypeAlias = Literal["cursor-agent", "gemini", "qwen-code", "copilot", "crush", "q", "opencode", "kilocode", "cline", "auggie", "warp", "droid"]
 HOST: TypeAlias = Literal["local", "docker"]
 PROVIDER: TypeAlias = Literal["azure", "google", "aws", "openai", "anthropic", "openrouter", "xai"]
-MODEL: TypeAlias = Literal["zai/glm-4.6", "anthropic/sonnet-4.5", "google/gemini-2.5-pro", "openai/gpt-5-codex",
-                           "openrouter/supernova", "openrouter/andromeda-alpha", "x-ai/grok-4-fast:free",
-                           ]
-PROVIDER2MODEL: dict[PROVIDER, list[MODEL]] = {
-    "azure": ["zai/glm-4.6"],
-    "google": ["google/gemini-2.5-pro"],
-    "aws": [],
-    "openai": ["openai/gpt-5-codex"],
-    "anthropic": ["anthropic/sonnet-4.5"],
-    "openrouter": ["openrouter/supernova", "openrouter/andromeda-alpha"],
-    "xai": ["x-ai/grok-4-fast:free"]
-}
 
 class AI_SPEC(TypedDict):
     provider: PROVIDER
-    model: MODEL
+    model: str
     agent: AGENTS
-    machine: HOST    
+    machine: HOST
+    api_key: str | None
+    api_name: str
 
 
 AGENT_NAME_FORMATTER = "agent_{idx}_cmd.sh"  # e.g., agent_0_cmd.sh

machineconfig/scripts/python/helpers_devops/cli_config.py

@@ -46,7 +46,7 @@ def path():
     uv_with = ["textual"]
     uv_project_dir = None
     if not Path.home().joinpath("code/machineconfig").exists():
-        uv_with.append("machineconfig>=6.86")
+        uv_with.append("machineconfig>=6.88")
     else:
         uv_project_dir = str(Path.home().joinpath("code/machineconfig"))
     run_shell_script(get_uv_command_executing_python_script(python_script=path.read_text(encoding="utf-8"), uv_with=uv_with, uv_project_dir=uv_project_dir)[0])

machineconfig/scripts/python/helpers_devops/cli_self.py

@@ -3,35 +3,42 @@ import typer
 from typing import Optional, Annotated
 
 
+def copy_both_assets():
+    import machineconfig.profile.create_helper as create_helper
+    create_helper.copy_assets_to_machine(which="scripts")
+    create_helper.copy_assets_to_machine(which="settings")
+
+
 def update(no_copy_assets: Annotated[bool, typer.Option("--no-assets-copy", "-na", help="Copy (overwrite) assets to the machine after the update")] = False):
     """🔄 UPDATE uv and machineconfig"""
     # from machineconfig.utils.source_of_truth import LIBRARY_ROOT
     # repo_root = LIBRARY_ROOT.parent.parent
     from pathlib import Path
     if Path.home().joinpath("code", "machineconfig").exists():
-        code = """
+        shell_script = """
 uv self update
 cd ~/code/machineconfig
 git pull
 uv tool install --upgrade --editable $HOME/code/machineconfig
     """
     else:
-        code = """
+        shell_script = """
 uv self update
 uv tool install --upgrade machineconfig
     """
     import platform
     if platform.system() == "Windows":
-        # from machineconfig.utils.code import run_shell_script_after_exit
-        # run_shell_script_after_exit(code)
-        print(f'please run {code} in powershell to update machineconfig')
+        from machineconfig.utils.code import exit_then_run_shell_script, get_uv_command_executing_python_script
+        from machineconfig.utils.meta import lambda_to_python_script
+        python_script = lambda_to_python_script(lambda: copy_both_assets(), in_global=True, import_module=False)
+        uv_command, _py_file = get_uv_command_executing_python_script(python_script=python_script, uv_with=["machineconfig"], uv_project_dir=None)
+        exit_then_run_shell_script(shell_script + "\n" + uv_command, strict=True)
     else:
         from machineconfig.utils.code import run_shell_script
-        run_shell_script(code)
+        run_shell_script(shell_script)
     if not no_copy_assets:
-        import machineconfig.profile.create_helper as create_helper
-        create_helper.copy_assets_to_machine(which="scripts")
-        create_helper.copy_assets_to_machine(which="settings")
+        copy_both_assets()
+
 def install(no_copy_assets: Annotated[bool, typer.Option("--no-assets-copy", "-na", help="Copy (overwrite) assets to the machine after the update")] = False):
     """📋 CLONE machienconfig locally and incorporate to shell profile for faster execution and nightly updates."""
     from machineconfig.utils.code import run_shell_script
@@ -41,9 +48,9 @@ def install(no_copy_assets: Annotated[bool, typer.Option("--no-assets-copy", "-n
     else:
         import platform
         if platform.system() == "Windows":
-            run_shell_script(r"""& "$HOME\.local\bin\uv.exe" tool install --upgrade "machineconfig>=6.86" """)
+            run_shell_script(r"""& "$HOME\.local\bin\uv.exe" tool install --upgrade "machineconfig>=6.88" """)
         else:
-            run_shell_script("""$HOME/.local/bin/uv tool install --upgrade "machineconfig>=6.86" """)
+            run_shell_script("""$HOME/.local/bin/uv tool install --upgrade "machineconfig>=6.88" """)
     from machineconfig.profile.create_shell_profile import create_default_shell_profile
     if not no_copy_assets:
         create_default_shell_profile()   # involves copying assets too
@@ -68,7 +75,7 @@ def navigate():
     path = Path(navigator.__file__).resolve().parent.joinpath("devops_navigator.py")
     from machineconfig.utils.code import run_shell_script
     if Path.home().joinpath("code/machineconfig").exists(): executable = f"""--project "{str(Path.home().joinpath("code/machineconfig"))}" --with textual"""
-    else: executable = """--with "machineconfig>=6.86,textual" """
+    else: executable = """--with "machineconfig>=6.88,textual" """
     run_shell_script(f"""uv run {executable} {path}""")
 
 

machineconfig/scripts/python/helpers_fire_command/file_wrangler.py

@@ -1,7 +1,7 @@
-
 from typing import Optional
 import os
 from machineconfig.utils.path_extended import PathExtended
+import platform
 
 
 def search_for_files_of_interest(path_obj: PathExtended):
@@ -125,3 +125,42 @@ def wrap_import_in_try_except(import_line: str, pyfile: str, repo_root: Optional
             sys.path.append(repo_root)
         exec(f"from {Path(pyfile).stem} import *")
         print(fr"✅ Successfully imported `{pyfile}`")
+
+
+def add_to_path(path_variable: str, directory: str) -> str:
+    """
+    Generate shell script to add directory to path_variable.
+    Handles both Windows (cmd) and Unix-like systems (bash/zsh).
+    Checks if variable exists before appending, otherwise creates it.
+    """
+    system = platform.system()
+    
+    if system == "Windows":
+        script = f"""# Check if {path_variable} is defined
+if (Test-Path env:{path_variable}) {{
+    Write-Host "Adding {directory} to existing {path_variable}"
+    $currentValue = [Environment]::GetEnvironmentVariable("{path_variable}", "User")
+    $newValue = "$currentValue;{directory}"
+    [Environment]::SetEnvironmentVariable("{path_variable}", $newValue, "User")
+    $env:{path_variable} = $newValue
+}} else {{
+    Write-Host "Creating new {path_variable} variable"
+    [Environment]::SetEnvironmentVariable("{path_variable}", "{directory}", "User")
+    $env:{path_variable} = "{directory}"
+}}
+Write-Host "{path_variable} is now: $env:{path_variable}\""""
+        return script
+    else:
+        script = f"""#!/bin/bash
+# Check if {path_variable} is defined and not empty
+if [ -z "${{{path_variable}}}" ]; then
+    echo "Creating new {path_variable} variable"
+    export {path_variable}="{directory}"
+else
+    echo "Adding {directory} to existing {path_variable}"
+    export {path_variable}="${{{path_variable}}}:{directory}"
+fi
+echo "{path_variable} is now: ${{{path_variable}}}"
+"""
+        return script
+

machineconfig/scripts/python/helpers_repos/cloud_repo_sync.py

@@ -80,7 +80,7 @@ git pull originEnc master
         uv_project_dir = f"""{str(Path.home().joinpath("code/machineconfig"))}"""
         uv_with = None
     else:
-        uv_with = ["machineconfig>=6.86"]
+        uv_with = ["machineconfig>=6.88"]
         uv_project_dir = None
 
     import tempfile

machineconfig/scripts/python/nw/mount_nfs

@@ -5,7 +5,7 @@
 # mkdir ~/data/local
 # sudo mount -o nolock,noatime,nodiratime,proto=tcp,timeo=600,retrans=2,noac alex-p51s-5:/home/alex/data/local ./data/local
 
-uv run --python 3.14 --with "machineconfig>=6.86" python -m machineconfig.scripts.python.mount_nfs
+uv run --python 3.14 --with "machineconfig>=6.88" python -m machineconfig.scripts.python.mount_nfs
 # Check if remote server is reachable and share folder exists
 if ! ping -c 1 "$remote_server" &> /dev/null; then
   echo "💥 Error: Remote server $remote_server is not reachable."