machineconfig 3.7__py3-none-any.whl → 7.69__py3-none-any.whl

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,25 +2,24 @@
 CC
 """
 
-from machineconfig.utils.path_extended import PathExtended as PathExtended
-from tenacity import retry, stop_after_attempt, wait_chain, wait_fixed
-import getpass
-import argparse
-import os
-from typing import Optional
+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)
@@ -61,33 +60,43 @@ def get_securely_shared_file(url: Optional[str] = None, folder: Optional[str] =
                 tmp_folder.delete()
 
 
-def arg_parser() -> None:
-    console.print(Panel("☁️  Cloud Copy Utility", title="[bold blue]Cloud Copy[/bold blue]", border_style="blue", width=152))
-
-    parser = argparse.ArgumentParser(description="🚀 Cloud CLI. It wraps rclone with sane defaults for optimum type time.")
-
-    # positional argument
-    parser.add_argument("source", help="📂 file/folder path to be taken from here.")
-    parser.add_argument("target", help="🎯 file/folder path to be be sent to here.")
 
-    parser.add_argument("--overwrite", "-w", help="✍️ Overwrite existing file.", action="store_true", default=ArgsDefaults.overwrite)
-    parser.add_argument("--share", "-s", help="🔗 Share file / directory", action="store_true", default=ArgsDefaults.share)
-    parser.add_argument("--rel2home", "-r", help="🏠 Relative to `myhome` folder", action="store_true", default=ArgsDefaults.rel2home)
-    parser.add_argument("--root", "-R", help="🌳 Remote root. None is the default, unless rel2home is raied, making the default `myhome`.", default=ArgsDefaults.root)
-
-    parser.add_argument("--key", "-k", help="🔑 Key for encryption", type=str, default=ArgsDefaults.key)
-    parser.add_argument("--pwd", "-p", help="🔒 Password for encryption", type=str, default=ArgsDefaults.pwd)
-    parser.add_argument("--encrypt", "-e", help="🔐 Encrypt before sending.", action="store_true", default=ArgsDefaults.encrypt)
-    parser.add_argument("--zip", "-z", help="📦 unzip after receiving.", action="store_true", default=ArgsDefaults.zip_)
-    parser.add_argument("--os_specific", "-o", help="💻 choose path specific for this OS.", action="store_true", default=ArgsDefaults.os_specific)
-
-    parser.add_argument("--config", "-c", help="⚙️ path to cloud.json file.", default=None)
-
-    args = parser.parse_args()
-    args_dict = vars(args)
-    source: str = args_dict.pop("source")
-    target: str = args_dict.pop("target")
-    args_obj = Args(**args_dict)
+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("--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,
+        rel2home=rel2home,
+        root=root,
+        key=key,
+        pwd=pwd,
+        encrypt=encrypt,
+        zip=zip_,
+        os_specific=os_specific,
+        config=config,
+    )
 
     if args_obj.config == "ss" and (source.startswith("http") or source.startswith("bit.ly")):
         console.print(Panel("🔒 Detected secure share link", title="[bold yellow]Warning[/bold yellow]", border_style="yellow"))
@@ -153,5 +162,9 @@ def arg_parser() -> None:
         raise ValueError(f"Cloud `{cloud}` not found in source or target.")
 
 
+def arg_parser() -> None:
+    typer.run(main)
+
+
 if __name__ == "__main__":
     arg_parser()

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

@@ -2,11 +2,11 @@
 
 from machineconfig.utils.options import choose_from_options
 from machineconfig.utils.io import read_ini
-from machineconfig.utils.path_extended import PathExtended as PathExtended
+from machineconfig.utils.path_extended import PathExtended
 
 import platform
-import argparse
-from typing import Optional
+from typing import Optional, Annotated
+import typer
 from rich.console import Console
 from rich.panel import Panel
 
@@ -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,18 +158,8 @@ zellij action move-focus up
     console.print(Panel(f"{title1}\n{title2}", title="Success", border_style="green"))
 
 
-def main():
-    # draw main title box dynamically
-    main_title = "☁️  RCLONE CLOUD MOUNT"
-    console.print(Panel(main_title, title_align="left", border_style="blue"))
-
-    parser = argparse.ArgumentParser(description="mount cloud")
-    parser.add_argument("cloud", nargs="?", type=str, default=None, help="cloud to mount")
-    parser.add_argument("destination", nargs="?", type=str, default=None, help="destination to mount")
-    parser.add_argument("--network", type=str, default=None, help="mount network drive")
-    args = parser.parse_args()
-    mount(cloud=args.cloud, network=args.network, destination=args.destination)
-
 
-if __name__ == "__main__":
-    main()
+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/helpers_cloud/cloud_sync.py

@@ -0,0 +1,81 @@
+"""CS
+TODO: use typer or typed-argument-parser to parse args
+"""
+
+
+from typing import Annotated, Optional
+import typer
+
+
+def main(
+    source: Annotated[str, typer.Argument(help="source")],
+    target: Annotated[str, typer.Argument(help="target")],
+    transfers: Annotated[int, typer.Option("--transfers", "-t", help="Number of threads in syncing.")] = 10,
+    root: Annotated[str, typer.Option("--root", "-R", help="Remote root.")] = "myhome",
+    key: Annotated[Optional[str], typer.Option("--key", "-k", help="Key for encryption")] = None,
+    pwd: Annotated[Optional[str], typer.Option("--pwd", "-P", help="Password for encryption")] = None,
+    encrypt: Annotated[bool, typer.Option("--encrypt", "-e", help="Decrypt after receiving.")] = False,
+    zip_: Annotated[bool, typer.Option("--zip", "-z", help="unzip after receiving.")] = False,
+    bisync: Annotated[bool, typer.Option("--bisync", "-b", help="Bidirectional sync.")] = False,
+    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"))
+
+    args_obj = Args(
+        root=root,
+        key=key,
+        pwd=pwd,
+        encrypt=encrypt,
+        zip=zip_,
+        rel2home=True,
+        os_specific=False,
+    )
+
+    cloud, source, target = parse_cloud_source_target(args=args_obj, source=source, target=target)
+    # map short flags to long flags (-u -> --upload), for easier use in the script
+    if bisync:
+        title = "🔄 BI-DIRECTIONAL SYNC"
+        source_line = f"Source: {source}"
+        target_line = f"Target: {target}"
+        console.print(Panel(f"{source_line}\n{target_line}", title=title, border_style="blue"))
+        rclone_cmd = f"""rclone bisync '{source}' '{target}' --resync"""
+    else:
+        title = "📤 ONE-WAY SYNC"
+        source_line = f"Source: {source}"
+        arrow_line = "↓"
+        target_line = f"Target: {target}"
+        console.print(Panel(f"{source_line}\n{arrow_line}\n{target_line}", title=title, border_style="blue"))
+        if delete:
+            rclone_cmd = f'rclone sync -P "{source}" "{target}" --delete-during --transfers={transfers}'
+        else:
+            rclone_cmd = f'rclone sync -P "{source}" "{target}" --transfers={transfers}'
+
+    rclone_cmd += f" --progress --transfers={transfers} --verbose"
+    # rclone_cmd += f"  --vfs-cache-mode full"
+    if delete:
+        rclone_cmd += " --delete-during"
+
+    if verbose:
+        txt = get_mprocs_mount_txt(cloud=cloud, rclone_cmd=rclone_cmd, cloud_brand="Unknown")
+    else:
+        txt = f"""{rclone_cmd}"""
+
+    title = "🚀 EXECUTING COMMAND"
+    cmd_line = f"{rclone_cmd[:65]}..."
+    console.print(Panel(f"{title}\n{cmd_line}", title="[bold blue]Command[/bold blue]", expand=False))
+
+    # import subprocess
+    # subprocess.run(txt, shell=True, check=True)
+    from machineconfig.utils.code import run_shell_script
+    run_shell_script(txt)
+

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
@@ -104,7 +104,7 @@ def parse_cloud_source_target(args: Args, source: str, target: str) -> tuple[str
         if len(source_parts) > 1 and source_parts[1] == ES:  # the source path is to be inferred from target.
             assert ES not in target, f"You can't use expand symbol `{ES}` in both source and target. Cyclical inference dependency arised."
             target_obj = absolute(target)
-            from machineconfig.utils.path_extended import PathExtended as PathExtended
+            from machineconfig.utils.path_extended import PathExtended
 
             remote_path = PathExtended(target_obj).get_remote_path(os_specific=os_specific, root=root, rel2home=rel2home, strict=False)
             source = f"{cloud}:{remote_path.as_posix()}"
@@ -124,7 +124,7 @@ def parse_cloud_source_target(args: Args, source: str, target: str) -> tuple[str
         if len(target_parts) > 1 and target_parts[1] == ES:  # the target path is to be inferred from source.
             assert ES not in source, "You can't use $ in both source and target. Cyclical inference dependency arised."
             source_obj = absolute(source)
-            from machineconfig.utils.path_extended import PathExtended as PathExtended
+            from machineconfig.utils.path_extended import PathExtended
 
             remote_path = PathExtended(source_obj).get_remote_path(os_specific=os_specific, root=root, rel2home=rel2home, strict=False)
             target = f"{cloud}:{remote_path.as_posix()}"

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/{scheduler.py → helpers_croshell/scheduler.py}

@@ -4,7 +4,6 @@
 # from machineconfig.utils.scheduling import PathExtended, Report, DEFAULT_CONFIG, read_task_from_dir, main
 
 # def main_parse():
-#     import argparse
 #     print("\n" + "=" * 50)
 #     print("📅 Welcome to the Scheduler CLI")
 #     print("=" * 50 + "\n")

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

@@ -2,22 +2,34 @@
 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 as PathExtended
-from machineconfig.utils.terminal import Terminal
+from machineconfig.utils.path_extended import PathExtended
+from machineconfig.utils.terminal import Response
+from typing import Annotated, Optional
+import typer
 import subprocess
 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...")
-    Terminal(stderr=subprocess.PIPE, stdin=subprocess.PIPE, stdout=subprocess.PIPE).run(f"cd {SLIDEV_REPO.parent};npm init slidev@latest")
+    subprocess.run(f"cd {SLIDEV_REPO.parent};npm init slidev@latest", check=False, shell=True, text=True)
     print("✅ Slidev repository initialized successfully!\n")
 
 
+def _execute_with_shell(command: str) -> Response:
+    if platform.system() == "Windows":
+        completed = subprocess.run(["powershell", "-Command", command], capture_output=True, check=False, text=True)
+    else:
+        completed = subprocess.run(command, capture_output=True, check=False, text=True, shell=True)
+    response = Response.from_completed_process(completed)
+    response.print()
+    return response
+
+
 def jupyter_to_markdown(file: PathExtended):
     op_dir = file.parent.joinpath("presentation")
     print("📝 Converting Jupyter notebook to markdown...")
@@ -33,9 +45,9 @@ def jupyter_to_markdown(file: PathExtended):
     # for key, value in resources['outputs'].items():
 
     cmd = f"jupyter nbconvert --to markdown --no-prompt --no-input --output-dir {op_dir} --output slides_raw.md {file}"
-    Terminal().run(cmd, shell="powershell").print()
+    _execute_with_shell(cmd)
     cmd = f"jupyter nbconvert --to html --no-prompt --no-input --output-dir {op_dir} {file}"
-    Terminal().run(cmd, shell="powershell").print()
+    _execute_with_shell(cmd)
 
     op_file = op_dir.joinpath("slides_raw.md")
     slide_separator = "\n\n---\n\n"
@@ -47,28 +59,24 @@ def jupyter_to_markdown(file: PathExtended):
     return op_dir
 
 
-def main() -> None:
-    import argparse
-
+def main(
+    directory: Annotated[Optional[str], typer.Option("-d", "--directory", help="📁 Directory of the report.")] = None,
+    jupyter_file: Annotated[Optional[str], typer.Option("-j", "--jupyter-file", help="📓 Jupyter notebook file to convert to slides. If not provided, slides.md is used.")] = None,
+) -> None:
     print("\n" + "=" * 50)
     print("🎥 Welcome to the Slidev Presentation Tool")
     print("=" * 50 + "\n")
 
-    parser = argparse.ArgumentParser()
-    parser.add_argument("-d", "--directory", default=None, help="📁 Directory of the report.")
-    parser.add_argument("-j", "--jupyter-file", default=None, help="📓 Jupyter notebook file to convert to slides. If not provided, slides.md is used.")
-    args = parser.parse_args()
-
     port = PORT_DEFAULT
 
-    if args.jupyter_file is not None:
+    if jupyter_file is not None:
         print("📓 Jupyter file provided. Converting to markdown...")
-        report_dir = jupyter_to_markdown(PathExtended(args.jupyter_file))
+        report_dir = jupyter_to_markdown(PathExtended(jupyter_file))
     else:
-        if args.directory is None:
+        if directory is None:
             report_dir = PathExtended.cwd()
         else:
-            report_dir = PathExtended(args.directory)
+            report_dir = PathExtended(directory)
 
     assert report_dir.exists(), f"❌ Directory {report_dir} does not exist."
     assert report_dir.is_dir(), f"❌ {report_dir} is not a directory."
@@ -108,5 +116,9 @@ def main() -> None:
     print_code(code=program, lexer="bash", desc="Run the following command to start the presentation")
 
 
+def arg_parser() -> None:
+    typer.run(main)
+
+
 if __name__ == "__main__":
-    main()
+    arg_parser()

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