machineconfig 5.15__py3-none-any.whl → 7.66__py3-none-any.whl

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

@@ -0,0 +1,30 @@
+
+from pathlib import Path
+import shlex
+from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import AI_SPEC
+
+
+def fire_qwen(ai_spec: AI_SPEC, prompt_path: Path, repo_root: Path, config_dir: str | None) -> str:
+    _ = ai_spec["provider"]
+    safe_path = shlex.quote(str(prompt_path))
+    match ai_spec["machine"]:
+        case "local":
+            cmd = f"""
+qwen --yolo --prompt {safe_path}
+    """
+        case "docker":
+            assert config_dir is not None, "When using docker, config_dir must be provided."
+            assert Path(config_dir).exists(), f"Provided config_dir {config_dir} does not exist."
+            oauth_creds = Path(config_dir).joinpath("oauth_creds.json")
+            settings = Path(config_dir).joinpath("settings.json")
+
+            cmd = f"""
+docker run -it --rm \
+  -v "{repo_root}:/workspace/{repo_root.name}" \
+  -v {shlex.quote(str(oauth_creds))}:/root/.qwen/oauth_creds.json \
+  -v {shlex.quote(str(settings))}:/root/.qwen/settings.json \
+  -w "/workspace/{repo_root.name}" \
+  statistician/machineconfig-ai:latest \
+  qwen --prompt "$PATH_PROMPT"
+"""
+    return cmd

machineconfig/scripts/python/{fire_agents_help_launch.py → helpers_agents/fire_agents_help_launch.py}

@@ -2,13 +2,12 @@
 import random
 import shlex
 from pathlib import Path
-from machineconfig.scripts.python.fire_agents_helper_types import AGENTS, AGENT_NAME_FORMATTER
+from machineconfig.scripts.python.helpers_agents.fire_agents_helper_types import AGENTS, AGENT_NAME_FORMATTER, HOST, PROVIDER, AI_SPEC
 
 
-def get_gemini_api_keys() -> list[str]:
+def get_api_keys(provider: PROVIDER) -> list[str]:
     from machineconfig.utils.io import read_ini
-
-    config = read_ini(Path.home().joinpath("dotfiles/creds/llm/gemini/api_keys.ini"))
+    config = read_ini(Path.home().joinpath(f"dotfiles/creds/llm/{provider}/api_keys.ini"))
     res: list[str] = []
     for a_section_name in list(config.sections()):
         a_section = config[a_section_name]
@@ -16,11 +15,12 @@ def get_gemini_api_keys() -> list[str]:
             api_key = a_section["api_key"].strip()
             if api_key:
                 res.append(api_key)
-    print(f"Found {len(res)} Gemini API keys configured.")
+    print(f"Found {len(res)} {provider} API keys configured.")
     return res
 
 
-def prep_agent_launch(agents_dir: Path, prompts_material: list[str], prompt_prefix: str, keep_material_in_separate_file: bool, agent: AGENTS, *, job_name: str) -> None:
+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: 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)
@@ -32,18 +32,22 @@ def prep_agent_launch(agents_dir: Path, prompts_material: list[str], prompt_pref
         if keep_material_in_separate_file:
             prompt_material_path = prompt_root / f"agent_{idx}_material.txt"
             prompt_material_path.write_text(a_prompt_material, encoding="utf-8")
-            prompt_path.write_text(prompt_prefix + f"""\nPlease only look @ {prompt_material_path}. You don't need to do any other work beside the content of this material file.""", encoding="utf-8")
+            prompt_path.write_text(prompt_prefix + f"""\nPlease only look @ {prompt_material_path.relative_to(repo_root)}. You don't need to do any other work beside the content of this material file.""", encoding="utf-8")
         else:
             prompt_material_path = prompt_path
             prompt_path.write_text(prompt_prefix + """\nPlease only look @ the following:\n""" + a_prompt_material, encoding="utf-8")
 
         agent_cmd_launch_path = prompt_root / AGENT_NAME_FORMATTER.format(idx=idx)  # e.g., agent_0_cmd.sh
         random_sleep_time = random.uniform(0, 5)
-        cmd_prefix = f"""
-#!/usr/bin/env bash
+        cmd_prefix = f"""#!/usr/bin/env bash
 
-# AGENT-{idx}-LAUNCH-SCRIPT
-# Auto-generated by fire_agents.py
+echo "Using machine: {machine}, model: {model}, provider: {provider}, and agent: {agent}"
+echo "{job_name}-{idx} CMD {agent_cmd_launch_path}"
+echo "{job_name}-{idx} PROMPT {prompt_path}"
+echo "{job_name}-{idx} CONTEXT {prompt_material_path}"
+echo "Starting agent {agent} in 5 seconds... Press Ctrl+C to cancel."
+# sleep 5
+# timeout 3 copilot --banner
 
 export FIRE_AGENTS_AGENT_NAME="{agent}"
 export FIRE_AGENTS_JOB_NAME="{job_name}"
@@ -53,54 +57,40 @@ export FIRE_AGENTS_AGENT_LAUNCHER="{agent_cmd_launch_path}"
 
 echo "Sleeping for {random_sleep_time:.2f} seconds to stagger agent startups..."
 sleep {random_sleep_time:.2f}
-echo "Launching agent {agent} with prompt from {prompt_path}"
-echo "Launching agent {agent} with command from {agent_cmd_launch_path}"
 echo "--------START OF AGENT OUTPUT--------"
 sleep 0.1
 
 """
         match agent:
             case "gemini":
-                model = "gemini-2.5-pro"
-                # model = "gemini-2.5-flash-lite"
-                # model = None  # auto-select
-                # if model is None:
-                #     model_arg = ""
-                # else:
-                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))
-                api_keys = get_gemini_api_keys()
-                api_key = api_keys[idx % len(api_keys)] if api_keys else ""
-                # Export the environment variable so it's available to subshells
-                cmd = f"""
-export GEMINI_API_KEY={shlex.quote(api_key)}
-echo "Using Gemini API key $GEMINI_API_KEY"
-gemini {model_arg} --yolo --prompt {safe_path}
-"""
+                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(ai_spec=ai_spec, prompt_path=prompt_path, repo_root=repo_root)
             case "cursor-agent":
-                # As originally implemented
-                cmd = f"""
-
-cursor-agent --print --output-format text < {prompt_path}
-
-"""
+                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(ai_spec=ai_spec, prompt_path=prompt_path)
+                raise NotImplementedError("Cursor agent is not implemented yet, api key missing")
             case "crush":
-                cmd = f"""
-crush run {prompt_path}
-"""
-            case "q":
-                cmd = f"""
-q chat --no-interactive --trust-all-tools {prompt_path}
-"""
+                api_keys = get_api_keys(provider=provider)
+                api_key = api_keys[idx % len(api_keys)] if len(api_keys) > 0 else None
+                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)
             case _:
                 raise ValueError(f"Unsupported agent type: {agent}")
+
         cmd_postfix = """
 sleep 0.1
 echo "---------END OF AGENT OUTPUT---------"
 """
         agent_cmd_launch_path.write_text(cmd_prefix + cmd + cmd_postfix, encoding="utf-8")
-
     return None
 
 

machineconfig/scripts/python/helpers_agents/fire_agents_helper_types.py

@@ -0,0 +1,34 @@
+
+from typing import Literal, TypeAlias, TypedDict
+
+
+# Vscode extensions for AI-assisted coding.
+# Github copilot
+# Roo
+# Cline
+# Kilocode
+# Continue
+# CodeGPT
+# qodo (and cli)
+
+# Editors based on AI
+# Kiro
+# Cursor
+# Warp
+
+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"]
+
+class AI_SPEC(TypedDict):
+    provider: PROVIDER
+    model: str
+    agent: AGENTS
+    machine: HOST
+    api_key: str | None
+    api_name: str
+
+
+AGENT_NAME_FORMATTER = "agent_{idx}_cmd.sh"  # e.g., agent_0_cmd.sh
+SEARCH_STRATEGIES: TypeAlias = Literal["file_path", "keyword_search", "filename_pattern"]
+

machineconfig/scripts/python/helpers_agents/templates/prompt.txt

@@ -0,0 +1,6 @@
+
+please look if it is possible to easily relpace PathExtended with normal Path from pathlib
+if its one or two lines of code, then go ahead and make it standard and stop using the extended library
+you focus ont he methods used, 
+
+only look at the files below

machineconfig/scripts/python/helpers_agents/templates/template.ps1

@@ -0,0 +1,14 @@
+# Set error action preference to stop on error, like set -e
+$ErrorActionPreference = "Stop"
+
+$JOB_NAME = "outpatient_mapping"
+$REPO_ROOT = "$HOME/code/work/winter_planning/"
+$CONTEXT_PATH = "$REPO_ROOT/data/outpatient_mapping/op_services.csv"
+$PROMPT_PATH = "$REPO_ROOT/data/outpatient_mapping/prompt"
+$AGENTS_DIR = "$REPO_ROOT/.ai/agents/$JOB_NAME"
+
+agents create --agents crush --host docker --model x-ai/grok-4-fast:free --provider openrouter --context-path $CONTEXT_PATH --prompt-path $PROMPT_PATH --job-name $JOB_NAME --agents-dir $AGENTS_DIR
+sessions balance-load "$AGENTS_DIR/layout.json" --max-thresh 6 --breaking-method moreLayouts --thresh-type number --output-path "$AGENTS_DIR/layout_balanced.json"
+sessions run "$AGENTS_DIR/layout_balanced.json" --kill-upon-completion
+
+# agents collect $AGENTS_DIR "$REPO_ROOT/.ai/agents/$JOB_NAME/collected.txt"

machineconfig/scripts/python/helpers_agents/templates/template.sh

@@ -0,0 +1,24 @@
+
+#!/bin/bash
+# set -e # Exit immediately if a command exits with a non-zero status.
+
+JOB_NAME="outpatient_mapping"
+REPO_ROOT="$HOME/code/machineconfig"
+CONTEXT_PATH="$REPO_ROOT/.ai/todo/files.md"
+# agents make-todo --strategy keywords from machineconfig.utils.path_extended import PathExtended
+PROMPT_PATH="$REPO_ROOT/src/machineconfig/scripts/python/helpers_agents/templates/prompt.txt"
+AGENTS_DIR="$REPO_ROOT/.ai/agents/$JOB_NAME"
+
+agents create --agents crush \
+    --host docker \
+    --model x-ai/grok-4-fast:free \
+    --provider openrouter \
+    --context-path $CONTEXT_PATH \
+    --prompt-path $PROMPT_PATH \
+    --job-name $JOB_NAME \
+    --agents-dir $AGENTS_DIR
+sessions balance-load "$AGENTS_DIR/layout.json" --max-thresh 6 --breaking-method moreLayouts --thresh-type number --output-path "$AGENTS_DIR/layout_balanced.json"
+sessions run "$AGENTS_DIR/layout_balanced.json" --kill-upon-completion
+
+
+# agents collect $AGENTS_DIR "$REPO_ROOT/.ai/agents/$JOB_NAME/collected.txt"

machineconfig/scripts/python/{cloud_copy.py → helpers_cloud/cloud_copy.py}

@@ -2,26 +2,24 @@
 CC
 """
 
-from machineconfig.utils.path_extended import PathExtended
-from tenacity import retry, stop_after_attempt, wait_chain, wait_fixed
-import getpass
-import os
 from typing import Optional, Annotated
-
 import typer
 
-from machineconfig.scripts.python.helpers.helpers2 import parse_cloud_source_target
-from machineconfig.scripts.python.helpers.cloud_helpers import ArgsDefaults, Args
-from rich.console import Console
-from rich.panel import Panel
-from rich.progress import Progress
-from machineconfig.utils.accessories import pprint
+from tenacity import retry, stop_after_attempt, wait_chain, wait_fixed
 
-console = Console()
 
 
 @retry(stop=stop_after_attempt(3), wait=wait_chain(wait_fixed(1), wait_fixed(4), wait_fixed(9)))
 def get_securely_shared_file(url: Optional[str] = None, folder: Optional[str] = None) -> None:
+    from rich.console import Console
+    from rich.panel import Panel
+    from rich.progress import Progress
+    import getpass
+    import os
+    from machineconfig.utils.path_extended import PathExtended
+
+    console = Console()
+
     console.print(Panel("🚀 Secure File Downloader", title="[bold blue]Downloader[/bold blue]", border_style="blue"))
 
     folder_obj = PathExtended.cwd() if folder is None else PathExtended(folder)
@@ -62,22 +60,31 @@ def get_securely_shared_file(url: Optional[str] = None, folder: Optional[str] =
                 tmp_folder.delete()
 
 
+
 def main(
     source: Annotated[str, typer.Argument(help="📂 file/folder path to be taken from here.")],
     target: Annotated[str, typer.Argument(help="🎯 file/folder path to be be sent to here.")],
-    overwrite: Annotated[bool, typer.Option(help="✍️ Overwrite existing file.")] = ArgsDefaults.overwrite,
-    share: Annotated[bool, typer.Option(help="🔗 Share file / directory")] = ArgsDefaults.share,
-    rel2home: Annotated[bool, typer.Option(help="🏠 Relative to `myhome` folder")] = ArgsDefaults.rel2home,
-    root: Annotated[Optional[str], typer.Option(help="🌳 Remote root. None is the default, unless rel2home is raied, making the default `myhome`.")] = ArgsDefaults.root,
-    key: Annotated[Optional[str], typer.Option(help="🔑 Key for encryption")] = ArgsDefaults.key,
-    pwd: Annotated[Optional[str], typer.Option(help="🔒 Password for encryption")] = ArgsDefaults.pwd,
-    encrypt: Annotated[bool, typer.Option(help="🔐 Encrypt before sending.")] = ArgsDefaults.encrypt,
-    zip_: Annotated[bool, typer.Option("--zip", "-z", help="📦 unzip after receiving.")] = ArgsDefaults.zip_,
-    os_specific: Annotated[bool, typer.Option(help="💻 choose path specific for this OS.")] = ArgsDefaults.os_specific,
-    config: Annotated[Optional[str], typer.Option(help="⚙️ path to cloud.json file.")] = None,
+    overwrite: Annotated[bool, typer.Option("--overwrite", "-o", help="✍️ Overwrite existing file.")] = False,
+    share: Annotated[bool, typer.Option("--share", "-s", help="🔗 Share file / directory")] = False,
+    rel2home: Annotated[bool, typer.Option("--relative2home", "-r", help="🏠 Relative to `myhome` folder")] = False,
+    root: Annotated[Optional[str], typer.Option("--root", "-R", help="🌳 Remote root. None is the default, unless rel2home is raied, making the default `myhome`.")] = None,
+    key: Annotated[Optional[str], typer.Option("--key", "-k", help="🔑 Key for encryption")] = None,
+    pwd: Annotated[Optional[str], typer.Option("--password", "-p", help="🔒 Password for encryption")] = None,
+    encrypt: Annotated[bool, typer.Option("--encrypt", "-e", help="🔐 Encrypt before sending.")] = False,
+    zip_: Annotated[bool, typer.Option("--zip", "-z", help="📦 unzip after receiving.")] = False,
+    os_specific: Annotated[bool, typer.Option("--os-specific", "-O", help="💻 choose path specific for this OS.")] = False,
+    config: Annotated[Optional[str], typer.Option("--config", "-c", help="⚙️ path to cloud.json file.")] = None,
 ) -> None:
+    """📤 Upload or 📥 Download files/folders to/from cloud storage services like Google Drive, Dropbox, OneDrive, etc."""
+    from rich.console import Console
+    from rich.panel import Panel
+    from machineconfig.utils.path_extended import PathExtended
+    from machineconfig.scripts.python.helpers_cloud.helpers2 import parse_cloud_source_target
+    from machineconfig.scripts.python.helpers_cloud.cloud_helpers import Args
+    from machineconfig.utils.accessories import pprint
+
+    console = Console()
     console.print(Panel("☁️  Cloud Copy Utility", title="[bold blue]Cloud Copy[/bold blue]", border_style="blue", width=152))
-
     args_obj = Args(
         overwrite=overwrite,
         share=share,

machineconfig/scripts/python/{cloud_mount.py → helpers_cloud/cloud_mount.py}

@@ -52,7 +52,12 @@ mprocs "echo 'see {DEFAULT_MOUNT}/{cloud} for the mounted cloud'; rclone about {
     return txt
 
 
-def mount(cloud: Optional[str], network: Optional[str], destination: Optional[str]) -> None:
+def mount(
+    cloud: Annotated[Optional[str], typer.Option(help="cloud to mount")] = None,
+    destination: Annotated[Optional[str], typer.Option(help="destination to mount")] = None,
+    network: Annotated[Optional[str], typer.Option(help="mount network drive")] = None,
+) -> None:
+
     # draw header box dynamically
     title = "☁️  Cloud Mount Utility"
     console.print(Panel(title, title_align="left", border_style="blue"))
@@ -153,21 +158,8 @@ zellij action move-focus up
     console.print(Panel(f"{title1}\n{title2}", title="Success", border_style="green"))
 
 
-def main(
-    cloud: Annotated[Optional[str], typer.Option(help="cloud to mount")] = None,
-    destination: Annotated[Optional[str], typer.Option(help="destination to mount")] = None,
-    network: Annotated[Optional[str], typer.Option(help="mount network drive")] = None,
-) -> None:
-    # draw main title box dynamically
-    main_title = "☁️  RCLONE CLOUD MOUNT"
-    console.print(Panel(main_title, title_align="left", border_style="blue"))
-
-    mount(cloud=cloud, network=network, destination=destination)
-
-
-def arg_parser() -> None:
-    typer.run(main)
-
 
-if __name__ == "__main__":
-    arg_parser()
+def get_app():
+    app = typer.Typer(name="cloud-mount", help="Cloud mount utility")
+    app.command(name="mount", no_args_is_help=True)(mount)
+    return app

machineconfig/scripts/python/{cloud_sync.py → helpers_cloud/cloud_sync.py}

@@ -2,16 +2,9 @@
 TODO: use typer or typed-argument-parser to parse args
 """
 
-from machineconfig.scripts.python.helpers.helpers2 import parse_cloud_source_target
-from machineconfig.scripts.python.helpers.cloud_helpers import Args
-from machineconfig.scripts.python.cloud_mount import get_mprocs_mount_txt
 
 from typing import Annotated, Optional
 import typer
-from rich.console import Console
-from rich.panel import Panel
-
-console = Console()
 
 
 def main(
@@ -27,6 +20,14 @@ def main(
     delete: Annotated[bool, typer.Option("--delete", "-D", help="Delete files in remote that are not in local.")] = False,
     verbose: Annotated[bool, typer.Option("--verbose", "-v", help="Verbosity of mprocs to show details of syncing.")] = False,
 ) -> None:
+
+    from machineconfig.scripts.python.helpers_cloud.helpers2 import parse_cloud_source_target
+    from machineconfig.scripts.python.helpers_cloud.cloud_helpers import Args
+    from machineconfig.scripts.python.helpers_cloud.cloud_mount import get_mprocs_mount_txt
+    from rich.console import Console
+    from rich.panel import Panel
+    console = Console()
+
     title = "☁️  Cloud Sync Utility"
     console.print(Panel(title, title_align="left", border_style="blue"))
 
@@ -73,15 +74,8 @@ def main(
     cmd_line = f"{rclone_cmd[:65]}..."
     console.print(Panel(f"{title}\n{cmd_line}", title="[bold blue]Command[/bold blue]", expand=False))
 
-    # PROGRAM_PATH.write_text(txt, encoding="utf-8")
-    import subprocess
-
-    subprocess.run(txt, shell=True, check=True)
-
-
-def arg_parser() -> None:
-    typer.run(main)
-
+    # import subprocess
+    # subprocess.run(txt, shell=True, check=True)
+    from machineconfig.utils.code import run_shell_script
+    run_shell_script(txt)
 
-if __name__ == "__main__":
-    arg_parser()

machineconfig/scripts/python/{helpers → helpers_cloud}/helpers2.py

@@ -1,4 +1,4 @@
-from machineconfig.scripts.python.helpers.cloud_helpers import Args, ArgsDefaults, absolute, find_cloud_config, get_secure_share_cloud_config
+from machineconfig.scripts.python.helpers_cloud.cloud_helpers import Args, ArgsDefaults, absolute, find_cloud_config, get_secure_share_cloud_config
 from machineconfig.utils.io import read_ini
 from machineconfig.utils.source_of_truth import DEFAULTS_PATH
 from machineconfig.utils.accessories import pprint

machineconfig/scripts/python/helpers_croshell/crosh.py

@@ -0,0 +1,39 @@
+
+
+def get_read_python_file_pycode(path: str, title: str):
+    from pathlib import Path
+    print("Reading code from path:", path)
+    pycode = Path(path).read_text(encoding="utf-8")
+    pycode = pycode.split("except Exception: print(pycode)")[2]
+    try:
+        # from rich.text import Text
+        from rich.panel import Panel
+        from rich.console import Console
+        from rich.syntax import Syntax
+        console = Console()
+        if pycode.strip() != "":
+            console.print(Panel(Syntax(pycode, lexer="python"), title=title), style="bold red")
+    except Exception: print(pycode)
+
+
+def get_read_data_pycode(path: str):
+    from rich.panel import Panel
+    from rich.text import Text
+    from rich.console import Console
+    from pathlib import Path
+    console = Console()
+    p = Path(path).absolute()
+    try:
+        from machineconfig.utils.files.read import Read
+        from machineconfig.utils.accessories import pprint
+        dat = Read.read(p)
+        if isinstance(dat, dict):
+            panel_title = f"📄 File Data: {p.name}"
+            console.print(Panel(Text(str(dat), justify="left"), title=panel_title, expand=False))
+            pprint(dat, p.name)
+        else:
+            panel_title = f"📄 Successfully read the file: {p.name}"
+            console.print(Panel(Text(str(dat), justify="left"), title=panel_title, expand=False))
+    except Exception as e:
+        error_message = f'''❌ ERROR READING FILE\nFile: {p.name}\nError: {e}'''
+        console.print(Panel(Text(error_message, justify="left"), title="Error", expand=False, border_style="red"))

machineconfig/scripts/python/{start_slidev.py → helpers_croshell/start_slidev.py}

@@ -2,7 +2,7 @@
 slidev
 """
 
-from machineconfig.utils.source_of_truth import CONFIG_PATH
+from machineconfig.utils.source_of_truth import CONFIG_ROOT
 from machineconfig.utils.code import print_code
 from machineconfig.utils.path_extended import PathExtended
 from machineconfig.utils.terminal import Response
@@ -13,7 +13,7 @@ import platform
 
 PORT_DEFAULT = 3030
 
-SLIDEV_REPO = PathExtended(CONFIG_PATH).joinpath(".cache/slidev")
+SLIDEV_REPO = PathExtended(CONFIG_ROOT).joinpath(".cache/slidev")
 if not SLIDEV_REPO.joinpath("components").exists():
     print("📦 Initializing Slidev repository...")
     subprocess.run(f"cd {SLIDEV_REPO.parent};npm init slidev@latest", check=False, shell=True, text=True)

machineconfig/scripts/python/helpers_devops/cli_config.py

@@ -0,0 +1,95 @@
+
+
+from typing import Literal, Annotated
+from pathlib import Path
+import typer
+import machineconfig.scripts.python.helpers_devops.cli_config_dotfile as dotfile_module
+import machineconfig.profile.create_links_export as create_links_export
+
+
+def configure_shell_profile(which: Annotated[Literal["default", "d", "nushell", "n"], typer.Option(..., "--which", "-w", help="Which shell profile to create/configure")]="default"):
+    """🔗 Configure your shell profile."""
+    from machineconfig.profile.create_shell_profile import create_default_shell_profile,  create_nu_shell_profile
+    match which:
+        case "nushell" | "n":
+            create_nu_shell_profile()
+            return
+        case "default" | "d":
+            create_default_shell_profile()
+            return
+    typer.echo(f"[red]Error:[/] Unknown shell profile type: {which}")
+
+
+
+def pwsh_theme():
+    """🔗 Select powershell prompt theme."""
+    import machineconfig.scripts.python.helpers_devops.themes as themes
+    file = Path(themes.__file__).parent / "choose_pwsh_theme.ps1"
+    import subprocess
+    subprocess.run(["pwsh", "-File", str(file)])
+
+
+def starship_theme():
+    """🔗 Select starship prompt theme."""
+    import subprocess
+    from machineconfig.utils.code import run_shell_script
+    
+    presets: list[str] = ["catppuccin-powerline", "pastel-powerline", "tokyo-night", "gruvbox-rainbow", "jetpack"]
+    config_path: Path = Path.home() / ".config" / "starship.toml"
+    
+    typer.echo("\n🚀 Starship Theme Selector\n")
+    for idx, preset in enumerate(presets, start=1):
+        typer.echo(f"{idx}. {preset}")
+    
+    choice: str = typer.prompt("Select a preset")
+    
+    try:
+        choice_idx: int = int(choice)
+        if 1 <= choice_idx <= len(presets):
+            selected_preset: str = presets[choice_idx - 1]
+            typer.echo(f"\n✨ Applying {selected_preset}...")
+            run_shell_script(f"""starship preset {selected_preset} -o {config_path}""")
+            typer.echo("\n📋 Preview:")
+            subprocess.run(["starship", "module", "all"], check=False)
+            typer.echo(f"\n✅ {selected_preset} applied!")
+        else:
+            typer.echo("❌ Invalid selection")
+    except ValueError:
+        typer.echo("❌ Please enter a valid number")
+
+
+def copy_assets(which: Annotated[Literal["scripts", "s", "settings", "t", "both", "b"], typer.Argument(..., help="Which assets to copy")]):
+    """🔗 Copy asset files from library to machine."""
+    import machineconfig.profile.create_helper as create_helper
+    match which:
+        case "both" | "b":
+            create_helper.copy_assets_to_machine(which="scripts")
+            create_helper.copy_assets_to_machine(which="settings")
+            return
+        case "scripts" | "s":
+            create_helper.copy_assets_to_machine(which="scripts")
+            return
+        case "settings" | "t":
+            create_helper.copy_assets_to_machine(which="settings")
+            return
+    typer.echo(f"[red]Error:[/] Unknown asset type: {which}")
+
+
+def get_app():
+    config_apps = typer.Typer(help="⚙️ [c] configuration subcommands", no_args_is_help=True, add_help_option=False, add_completion=False)
+    config_apps.command("private", no_args_is_help=True, help="🔗  [v] Manage private configuration files.")(create_links_export.main_private_from_parser)
+    config_apps.command("v", no_args_is_help=True, hidden=True)(create_links_export.main_private_from_parser)
+    config_apps.command("public", no_args_is_help=True, help="🔗  [b] Manage public configuration files.")(create_links_export.main_public_from_parser)
+    config_apps.command("b", no_args_is_help=True, help="Manage public configuration files.", hidden=True)(create_links_export.main_public_from_parser)
+    config_apps.command("dotfile", no_args_is_help=True, help="🔗  [d] Manage dotfiles.")(dotfile_module.main)
+    config_apps.command("d", no_args_is_help=True,  hidden=True)(dotfile_module.main)
+    config_apps.command("shell", no_args_is_help=False, help="🔗  [s] Configure your shell profile.")(configure_shell_profile)
+    config_apps.command("s", no_args_is_help=False, help="Configure your shell profile.", hidden=True)(configure_shell_profile)
+    config_apps.command("starship-theme", no_args_is_help=False, help="🔗  [t] Select starship prompt theme.")(starship_theme)
+    config_apps.command("t", no_args_is_help=False, help="Select starship prompt theme.", hidden=True)(starship_theme)
+    config_apps.command("pwsh-theme", no_args_is_help=False, help="🔗  [T] Select powershell prompt theme.")(pwsh_theme)
+    config_apps.command("T", no_args_is_help=False, help="Select powershell prompt theme.", hidden=True)(pwsh_theme)
+
+    config_apps.command("copy-assets", no_args_is_help=True, help="🔗  [c] Copy asset files from library to machine.", hidden=False)(copy_assets)
+    config_apps.command("c", no_args_is_help=True, help="Copy asset files from library to machine.", hidden=True)(copy_assets)
+    return config_apps