machineconfig 2.0__py3-none-any.whl → 2.1__py3-none-any.whl

machineconfig/profile/shell.py

@@ -1,8 +1,7 @@
-"""shell
-"""
+"""shell"""
 
 from machineconfig.utils.utils2 import randstr
-from machineconfig.utils.path_reduced import P as PathExtended, modify_text
+from machineconfig.utils.path_reduced import PathExtended as PathExtended, modify_text
 from machineconfig.utils.terminal import Terminal
 from machineconfig.utils.utils import LIBRARY_ROOT, REPO_ROOT, display_options
 import platform
@@ -27,8 +26,10 @@ BOX_WIDTH = 100  # Define BOX_WIDTH or get it from a config
 def create_default_shell_profile() -> None:
     profile_path = get_shell_profile_path()
     profile = profile_path.read_text(encoding="utf-8")
-    if system == "Windows": source = f""". {str(LIBRARY_ROOT.joinpath('settings/shells/pwsh/init.ps1').collapseuser()).replace('~', '$HOME')}"""
-    else: source = f"""source {str(LIBRARY_ROOT.joinpath('settings/shells/bash/init.sh').collapseuser()).replace('~', '$HOME')}"""
+    if system == "Windows":
+        source = f""". {str(LIBRARY_ROOT.joinpath("settings/shells/pwsh/init.ps1").collapseuser()).replace("~", "$HOME")}"""
+    else:
+        source = f"""source {str(LIBRARY_ROOT.joinpath("settings/shells/bash/init.sh").collapseuser()).replace("~", "$HOME")}"""
 
     if source in profile:
         console.print(Panel("🔄 PROFILE | Skipping init script sourcing - already present in profile", title="[bold blue]Profile[/bold blue]", border_style="blue"))
@@ -49,17 +50,20 @@ def get_shell_profile_path() -> PathExtended:
     if system == "Windows":
         obj = Terminal().run("$PROFILE", shell="pwsh")
         res = obj.op2path()
-        if isinstance(res, PathExtended): profile_path = res
+        if isinstance(res, PathExtended):
+            profile_path = res
         else:
             obj.print(capture=False)
             raise ValueError(f"""Could not get profile path for Windows. Got {res}""")
-    elif system == "Linux": profile_path = PathExtended("~/.bashrc").expanduser()
-    else: raise ValueError(f"""Not implemented for this system {system}""")
+    elif system == "Linux":
+        profile_path = PathExtended("~/.bashrc").expanduser()
+    else:
+        raise ValueError(f"""Not implemented for this system {system}""")
     console.print(Panel(f"""🐚 SHELL PROFILE | Working with path: `{profile_path}`""", title="[bold blue]Shell Profile[/bold blue]", border_style="blue"))
     return profile_path
 
 
-def append_temporarily(dirs: list[str], kind: Literal['append', 'prefix', 'replace']) -> str:
+def append_temporarily(dirs: list[str], kind: Literal["append", "prefix", "replace"]) -> str:
     dirs_ = []
     for path in dirs:
         path_rel = PathExtended(path).collapseuser(strict=False)
@@ -68,24 +72,33 @@ def append_temporarily(dirs: list[str], kind: Literal['append', 'prefix', 'repla
         else:
             dirs_.append(path_rel.as_posix() if system == "Linux" else str(path_rel))
     dirs = dirs_
-    if len(dirs) == 0: return ""
+    if len(dirs) == 0:
+        return ""
 
     if system == "Windows":
         """Source: https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_environment_variables?view=powershell-7.2"""
-        if kind == "append": command = fr'$env:Path += ";{sep.join(dirs)}"'  # Append to the Path variable in the current window:
-        elif kind == "prefix": command = fr'$env:Path = "{sep.join(dirs)};" + $env:Path'  # Prefix the Path variable in the current window:
-        elif kind == "replace": command = fr'$env:Path = "{sep.join(dirs)}"'  # Replace the Path variable in the current window (use with caution!):
-        else: raise KeyError
+        if kind == "append":
+            command = rf'$env:Path += ";{sep.join(dirs)}"'  # Append to the Path variable in the current window:
+        elif kind == "prefix":
+            command = rf'$env:Path = "{sep.join(dirs)};" + $env:Path'  # Prefix the Path variable in the current window:
+        elif kind == "replace":
+            command = rf'$env:Path = "{sep.join(dirs)}"'  # Replace the Path variable in the current window (use with caution!):
+        else:
+            raise KeyError
         return command  # if run is False else tm.run(command, shell="powershell")
-    elif system in ["Linux", "Darwin"]: result = f'export PATH="{sep.join(dirs)}:$PATH"'
-    else: raise ValueError
+    elif system in ["Linux", "Darwin"]:
+        result = f'export PATH="{sep.join(dirs)}:$PATH"'
+    else:
+        raise ValueError
     return result
 
+
 def main_env_path(choice: Optional[str], profile_path: Optional[str]) -> None:
     from machineconfig.utils.utils2 import read_toml
+
     env_path = read_toml(LIBRARY_ROOT.joinpath("profile/env_path.toml"))
     # env_path = LIBRARY_ROOT.joinpath("profile/env_path.toml").readit()
-    dirs = env_path[f'path_{system.lower()}']['extension']
+    dirs = env_path[f"path_{system.lower()}"]["extension"]
 
     console.print(Panel("🔍 ENVIRONMENT | Current PATH variables:", title="[bold blue]Environment[/bold blue]", border_style="blue"))
 
@@ -93,8 +106,10 @@ def main_env_path(choice: Optional[str], profile_path: Optional[str]) -> None:
         tmp = display_options(msg="Which directory to add?", options=dirs + ["all", "none(EXIT)"], default="none(EXIT)")
         assert isinstance(tmp, str), f"Choice must be a string or a list of strings, not {type(choice)}"
         choice = tmp
-        if str(choice) != "all": dirs = [choice]
-    if choice == "none(EXIT)": return
+        if str(choice) != "all":
+            dirs = [choice]
+    if choice == "none(EXIT)":
+        return
 
     console.print(f"\n📌 Adding directories to PATH: {dirs}")
     addition = append_temporarily(dirs=dirs, kind="append")
@@ -111,23 +126,29 @@ def main_env_path(choice: Optional[str], profile_path: Optional[str]) -> None:
 def main_add_sources_to_shell_profile(profile_path: Optional[str], choice: Optional[str]) -> None:
     # sources: list[str] = LIBRARY_ROOT.joinpath("profile/sources.toml").readit()[system.lower()]['files']
     from machineconfig.utils.utils2 import read_toml
-    sources: list[str] = read_toml(LIBRARY_ROOT.joinpath("profile/sources.toml"))[system.lower()]['files']
+
+    sources: list[str] = read_toml(LIBRARY_ROOT.joinpath("profile/sources.toml"))[system.lower()]["files"]
 
     console.print(Panel("🔄 Adding sources to shell profile", title="[bold blue]Sources[/bold blue]", border_style="blue"))
 
     if choice is None:
         choice_obj = display_options(msg="Which patch to add?", options=sources + ["all", "none(EXIT)"], default="none(EXIT)", multi=True)
         if isinstance(choice_obj, str):
-            if choice_obj == "all": choice = choice_obj
-            elif choice_obj == "none(EXIT)": return
-            else: sources = [choice_obj]
+            if choice_obj == "all":
+                choice = choice_obj
+            elif choice_obj == "none(EXIT)":
+                return
+            else:
+                sources = [choice_obj]
         else:  # isinstance(choice_obj, list):
             sources = choice_obj
-    elif choice == "none(EXIT)": return
+    elif choice == "none(EXIT)":
+        return
 
     if isinstance(profile_path, str):
         profile_path_obj = PathExtended(profile_path)
-    else: profile_path_obj = get_shell_profile_path()
+    else:
+        profile_path_obj = get_shell_profile_path()
     profile = profile_path_obj.read_text(encoding="utf-8")
 
     for a_file in sources:
@@ -141,7 +162,8 @@ def main_add_sources_to_shell_profile(profile_path: Optional[str], choice: Optio
             elif system == "Linux":
                 profile += f"\nsource {file}"
                 console.print(f"➕ Added Bash source: {file}")
-            else: raise ValueError(f"Not implemented for this system {system}")
+            else:
+                raise ValueError(f"Not implemented for this system {system}")
         else:
             console.print(f"⏭️  Source already present: {file}")
 
@@ -158,7 +180,8 @@ def main_add_patches_to_shell_profile(profile_path: Optional[str], choice: Optio
         choice_chosen = display_options(msg="Which patch to add?", options=list(patches) + ["all", "none(EXIT)"], default="none(EXIT)", multi=False)
         assert isinstance(choice_chosen, str), f"Choice must be a string or a list of strings, not {type(choice)}"
         choice = choice_chosen
-    if choice == "none(EXIT)": return None
+    if choice == "none(EXIT)":
+        return None
     elif str(choice) == "all":
         console.print("📌 Adding all patches to profile")
     else:
@@ -187,5 +210,5 @@ def main_add_patches_to_shell_profile(profile_path: Optional[str], choice: Optio
     console.print(Panel("✅ Shell profile updated with patches", title="[bold blue]Patches[/bold blue]", border_style="blue"))
 
 
-if __name__ == '__main__':
+if __name__ == "__main__":
     pass

machineconfig/scripts/cloud/init.sh

@@ -59,7 +59,7 @@ curl bit.ly/cfgvelinux -L | bash
 
 # Activate virtual environment
 echo "🚀 Activating Python virtual environment..."
-. $HOME/venvs/ve/bin/activate
+. $HOME/code/machineconfig/.venv/bin/activate
 
 # Clone repositories
 echo "📋 Setting up code repositories..."
@@ -94,7 +94,7 @@ echo """#=======================================================================
 
 # Activate virtual environment
 echo "🚀 Activating Python virtual environment..."
-. $HOME/scripts/activate_ve 've'
+. $HOME/scripts/activate_ve '.venv'
 
 # Install all essential development applications
 echo "📥 Installing essential development applications..."

machineconfig/scripts/linux/checkout_versions

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-. $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
 python -m fire machineconfig.jobs.python.checkout_version main
 if [ -n "$VIRTUAL_ENV" ]; then
   deactivate || true

machineconfig/scripts/linux/choose_wezterm_theme

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-. $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
 python -m fire machineconfig.scripts.python.choose_wezterm_theme main
 source ~/.bashrc  # reload the profile
 if [ -n "$VIRTUAL_ENV" ]; then

machineconfig/scripts/linux/cloud_copy

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-. $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
 
 python -m machineconfig.scripts.python.cloud_copy "$@"
 

machineconfig/scripts/linux/cloud_manager

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-. $HOME/scripts/activate_ve ve
+source ~/code/machineconfig/.venv/bin/activate
 python -i -m machineconfig.scripts.python.cloud_manager "$@"
 
 if [ -n "$VIRTUAL_ENV" ]; then

machineconfig/scripts/linux/cloud_mount

@@ -2,7 +2,7 @@
 
 # check below if VIRTUAL_ENV is set
 # if [ -z "$VIRTUAL_ENV" ]; then
-source $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
 # fi
 
 op_script=$HOME/tmp_results/shells/python_return_command.sh

machineconfig/scripts/linux/cloud_repo_sync

@@ -6,7 +6,7 @@ if [ -f "$op_script" ]; then
 fi
 
 
-. $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
 
 python $(dirname $(dirname $0))/python/cloud_repo_sync.py "$@"
 

machineconfig/scripts/linux/cloud_sync

@@ -2,7 +2,7 @@
 
 # check below if VIRTUAL_ENV is set
 # if [ -z "$VIRTUAL_ENV" ]; then
-source $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
 # fi
 
 op_script=$HOME/tmp_results/shells/python_return_command.sh

machineconfig/scripts/linux/croshell

@@ -6,7 +6,7 @@ if [ -f "$op_script" ]; then
   rm $op_script
 fi
 
-source $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
 
 python -m machineconfig.scripts.python.croshell "$@"
 # python $(dirname $(dirname $0))/python/fire_jobs.py "$@"

machineconfig/scripts/linux/devops

@@ -1,17 +1,15 @@
 #!/usr/bin/env bash
 
-# check below if VIRTUAL_ENV is set
-# if [ -z "$VIRTUAL_ENV" ]; then
-#   source ~/scripts/activate_ve ''
-# fi
-# source ~/scripts/activate_ve ve  # this script only works under ve default ve.
+source ~/code/machineconfig/.venv/bin/activate
 
 op_script=$HOME/tmp_results/shells/python_return_command.sh
 if [ -f "$op_script" ]; then
   rm $op_script
 fi
 
-uv run --no-dev --project ~/code/machineconfig python -m machineconfig.scripts.python.devops "$@"
+# uv run --no-dev --project ~/code/machineconfig python -m machineconfig.scripts.python.devops "$@"
+python -m machineconfig.scripts.python.devops "$@"
+
 if [ -f "$op_script" ]; then
   chmod +x $op_script
   source $op_script

machineconfig/scripts/linux/fire

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-. $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
 
 # Generate random string of length 5
 random_str=$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 10 | head -n 1)

machineconfig/scripts/linux/fire_agents

@@ -1,6 +1,7 @@
 #!/usr/bin/env bash
 
-. $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
+
 
 # Generate random string of length 5
 random_str=$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 10 | head -n 1)
@@ -17,7 +18,7 @@ if [ -f "$op_script" ]; then
   echo "Running $op_script"
   chmod +x $op_script
   set --  # clear all positional parameters
-  source $op_script  # sourcing the script means the args passed to the this script are passed to the sourced script which cofuses the sources script as it contains activate_ve and it doesn't understand first.sh arguments.
+  source $op_script  # sourcing the script means the args passed to the this script are passed to the sourced script which cofuses the sources script as it  and it doesn't understand first.sh arguments.
 fi
 
 

machineconfig/scripts/linux/ftpx

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-. $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
 python $(dirname $(dirname $0))/python/ftpx.py "$@"
 if [ -n "$VIRTUAL_ENV" ]; then
   deactivate || true

machineconfig/scripts/linux/gh_models

@@ -1,7 +1,7 @@
 
 #!/usr/bin/env bash
 
-. $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
 
 python -m machineconfig.scripts.python.gh_models "$@"
 

machineconfig/scripts/linux/kill_process

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-. $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
 
 python -c "from machineconfig.utils.procs import ProcessManager; ProcessManager().choose_and_kill()"
 

machineconfig/scripts/linux/mcinit

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-. $HOME/scripts/activate_ve 've'
+. $HOME/code/machineconfig/.venv/bin/activate
 
 # Generate random string of length 5
 random_str=$(cat /dev/urandom | tr -dc 'a-zA-Z0-9' | fold -w 10 | head -n 1)

machineconfig/scripts/linux/repos

@@ -2,7 +2,7 @@
 
 # check below if VIRTUAL_ENV is set
 # if [ -z "$VIRTUAL_ENV" ]; then
-source $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
 # fi
 
 op_script=$HOME/tmp_results/shells/python_return_command.sh

machineconfig/scripts/linux/scheduler

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-. $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
 python -m machineconfig.scripts.python.scheduler "$@"
 if [ -n "$VIRTUAL_ENV" ]; then
   deactivate || true

machineconfig/scripts/linux/start_slidev

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-. $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
 
 op_script=$HOME/tmp_results/shells/python_return_command.sh
 if [ -f "$op_script" ]; then

machineconfig/scripts/linux/start_terminals

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-. $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
 
 python -m machineconfig.jobs.python.create_zellij_template
 

machineconfig/scripts/linux/url2md

@@ -1,6 +1,6 @@
 #!/usr/bin/env bash
 
-. $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
 
 python -m machineconfig.utils.ai.url2md "$@"
 

machineconfig/scripts/linux/warp-cli.sh

@@ -0,0 +1,122 @@
+#!/usr/bin/env bash
+# Installs Cloudflare WARP (warp-cli) on supported Ubuntu / Debian systems.
+# Usage: sudo ./warp-cli.sh [--allow-unsupported] [--force-reinstall]
+
+set -euo pipefail
+
+ALLOW_UNSUPPORTED=0
+FORCE_REINSTALL=0
+
+for arg in "$@"; do
+  case "$arg" in
+    --allow-unsupported) ALLOW_UNSUPPORTED=1 ;;
+    --force-reinstall) FORCE_REINSTALL=1 ;;
+    -h|--help)
+      printf "Usage: %s [--allow-unsupported] [--force-reinstall]\n" "$0"
+      exit 0
+      ;;
+    *)
+      printf "Unknown argument: %s\n" "$arg" >&2
+      exit 2
+      ;;
+  esac
+done
+
+require_root() {
+  if [ "${EUID}" -ne 0 ]; then
+    printf "Please run as root (use sudo).\n" >&2
+    exit 1
+  fi
+}
+
+have_cmd() { command -v "$1" >/dev/null 2>&1; }
+
+detect_os() {
+  if have_cmd lsb_release; then
+    DIST_ID=$(lsb_release -si 2>/dev/null | tr '[:upper:]' '[:lower:]')
+    CODENAME=$(lsb_release -sc 2>/dev/null | tr '[:upper:]' '[:lower:]')
+  elif [ -f /etc/os-release ]; then
+    # shellcheck disable=SC1091
+    . /etc/os-release
+    DIST_ID=$(printf "%s" "${ID:-}" | tr '[:upper:]' '[:lower:]')
+    CODENAME=$(printf "%s" "${VERSION_CODENAME:-}" | tr '[:upper:]' '[:lower:]')
+  else
+    printf "Cannot detect distribution. Install lsb_release or provide /etc/os-release.\n" >&2
+    exit 1
+  fi
+}
+
+is_supported() {
+  case "$DIST_ID" in
+    ubuntu)
+      # Supported: noble jammy focal (older: bionic xenial)
+      case "$CODENAME" in
+        noble|jammy|focal|bionic|xenial) return 0 ;; esac ;;
+    debian)
+      # Supported: bookworm bullseye buster (older: stretch)
+      case "$CODENAME" in
+        bookworm|bullseye|buster|stretch) return 0 ;; esac ;;
+  esac
+  return 1
+}
+
+add_key() {
+  local key_path="/usr/share/keyrings/cloudflare-warp-archive-keyring.gpg"
+  if [ -s "$key_path" ]; then
+    return 0
+  fi
+  curl -fsSL https://pkg.cloudflareclient.com/pubkey.gpg | gpg --yes --dearmor --output "$key_path"
+}
+
+add_repo() {
+  local list_file="/etc/apt/sources.list.d/cloudflare-client.list"
+  if grep -q "pkg.cloudflareclient.com" "$list_file" 2>/dev/null; then
+    return 0
+  fi
+  echo "deb [signed-by=/usr/share/keyrings/cloudflare-warp-archive-keyring.gpg] https://pkg.cloudflareclient.com/ ${CODENAME} main" > "$list_file"
+}
+
+need_update=0
+install_package() {
+  if dpkg -s cloudflare-warp >/dev/null 2>&1; then
+    if [ "$FORCE_REINSTALL" -eq 1 ]; then
+      apt-get install --reinstall -y cloudflare-warp
+    else
+      printf "cloudflare-warp already installed. Use --force-reinstall to reinstall.\n"
+    fi
+  else
+    apt-get install -y cloudflare-warp
+  fi
+}
+
+main() {
+  require_root
+  if ! have_cmd apt-get; then
+    printf "apt-get not found. This script supports only Debian/Ubuntu.\n" >&2
+    exit 1
+  fi
+  detect_os
+  if ! is_supported; then
+    if [ "$ALLOW_UNSUPPORTED" -ne 1 ]; then
+      printf "Distribution %s (%s) not in supported list. Use --allow-unsupported to proceed.\n" "$DIST_ID" "$CODENAME" >&2
+      exit 3
+    else
+      printf "Proceeding on unsupported distribution %s (%s).\n" "$DIST_ID" "$CODENAME"
+    fi
+  fi
+  pre_key_checksum=$( [ -f /usr/share/keyrings/cloudflare-warp-archive-keyring.gpg ] && sha256sum /usr/share/keyrings/cloudflare-warp-archive-keyring.gpg | cut -d' ' -f1 || true )
+  add_key
+  post_key_checksum=$(sha256sum /usr/share/keyrings/cloudflare-warp-archive-keyring.gpg | cut -d' ' -f1)
+  if [ "$pre_key_checksum" != "$post_key_checksum" ]; then need_update=1; fi
+  repo_before=$(grep -R "pkg.cloudflareclient.com" /etc/apt/sources.list.d 2>/dev/null || true)
+  add_repo
+  repo_after=$(grep -R "pkg.cloudflareclient.com" /etc/apt/sources.list.d 2>/dev/null || true)
+  if [ "$repo_before" != "$repo_after" ]; then need_update=1; fi
+  if [ "$need_update" -eq 1 ]; then
+    apt-get update
+  fi
+  install_package
+  printf "Done. Basic usage: 'warp-cli register' then 'warp-cli connect'. For account: 'warp-cli set-mode warp'.\n"
+}
+
+main "$@"

machineconfig/scripts/linux/wifi_conn

@@ -2,7 +2,7 @@
 
 # check below if VIRTUAL_ENV is set
 # if [ -z "$VIRTUAL_ENV" ]; then
-source $HOME/scripts/activate_ve 've'
+source ~/code/machineconfig/.venv/bin/activate
 # fi
 
 op_script=$HOME/tmp_results/shells/python_return_command.sh

machineconfig/scripts/python/ai/generate_files.py

@@ -0,0 +1,84 @@
+
+#!/usr/bin/env python3
+"""Script to generate a markdown table with checkboxes for all Python files in the repo."""
+
+from pathlib import Path
+
+
+def get_python_files(repo_root: Path) -> list[str]:
+    """Get all Python files relative to repo root."""
+    # Get all .py files recursively
+    py_files = list(repo_root.glob("**/*.py"))
+    
+    # Filter out files in .venv and __pycache__ directories
+    filtered_files = []
+    for file_path in py_files:
+        relative_path = file_path.relative_to(repo_root)
+        path_parts = relative_path.parts
+        
+        # Skip files in .venv or __pycache__ directories
+        if any(part in {".venv", "__pycache__"} for part in path_parts):
+            continue
+            
+        filtered_files.append(str(relative_path))
+    
+    return sorted(filtered_files)
+
+
+def generate_markdown_table(files: list[str]) -> str:
+    """Generate markdown table with checkboxes."""
+    header = "# Python Files Checklist\n\n"
+    table = "| Index | File Path | Status |\n|-------|-----------|--------|\n"
+    
+    for index, file_path in enumerate(files, start=1):
+        # Remove leading ./ if present
+        clean_path = file_path.lstrip('./')
+        table += f"| {index} | {clean_path} | - [ ] |\n"
+    
+    return header + table
+
+
+def main() -> None:
+    """Main function."""
+    repo_root = Path.cwd()
+    if not repo_root.joinpath("pyproject.toml").exists():
+        raise RuntimeError(f" {repo_root} Not a repo root")
+    output_file = repo_root / ".ai" / "all_files_with_index.md"
+    
+    print(f"Repo root: {repo_root}")
+    print(f"Output file: {output_file}")
+    
+    # Ensure output directory exists
+    output_file.parent.mkdir(parents=True, exist_ok=True)
+    
+    # Get Python files
+    python_files = get_python_files(repo_root)
+    print(f"Found {len(python_files)} Python files")
+    
+    # Generate markdown
+    markdown_content = generate_markdown_table(python_files)
+    print(f"Generated markdown content length: {len(markdown_content)}")
+    
+    # Write to file
+    output_file.write_text(markdown_content)
+    print(f"Generated {output_file} with {len(python_files)} Python files")
+    
+    # Create 5 symlinks to repo_root at ~/code_copies/${repo_name}_copy_{i}
+    import pathlib
+    # import os
+    repo_root = pathlib.Path.cwd().resolve()
+    repo_name: str = pathlib.Path(repo_root).name
+    symlink_dir: pathlib.Path = pathlib.Path.home() / "code_copies"
+    symlink_dir.mkdir(exist_ok=True)
+    for i in range(1, 6):
+        symlink_path: pathlib.Path = symlink_dir / f"{repo_name}_copy_{i}"
+        if symlink_path.exists() or symlink_path.is_symlink():
+            symlink_path.unlink()
+        symlink_path.symlink_to(repo_root, target_is_directory=True)
+    # Windows equivalent (comment):
+    # for /l %i in (1,1,5) do mklink /D "%USERPROFILE%\code_copies\{repo_name}_copy_%i" "C:\path\to\repo_root"
+
+
+if __name__ == "__main__":
+    main()
+