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

machineconfig/scripts/windows/wsl_rdp_windows_port_forwarding.ps1

@@ -1,46 +0,0 @@
-
-
-$port_num = 3391
-wsl.exe -u root service xrdp start  # added by me, to ensure sshd is fired.
-wsl.exe -u root service xrdp status
-# If elevation needed, start new process
-If (-NOT ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator))
-{
-  # Relaunch as an elevated process:
-  Start-Process powershell.exe "-File",('"{0}"' -f $MyInvocation.MyCommand.Path),"$Args runas" -Verb RunAs
-  exit
-}
-
-
-# Check WSL ip address
-wsl hostname -I | Set-Variable -Name "WSL"
-$found = $WSL -match '\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}';
-if (-not $found) {
-  echo "WSL2 cannot be found. Terminate script.";
-  exit;
-}
-
-
-# Remove and Create NetFireWallRule
-Remove-NetFireWallRule -DisplayName 'WSL 2 Firewall Unlock';
-if ($Args[0] -ne "delete") {
-  New-NetFirewallRule -DisplayName 'WSL 2 Firewall Unlock2' -Direction Outbound -LocalPort ($port_num) -Action Allow -Protocol TCP;
-  New-NetFirewallRule -DisplayName 'WSL 2 Firewall Unlock2' -Direction Inbound -LocalPort ($port_num) -Action Allow -Protocol TCP;
-}
-
-# Add each port into portproxy
-$Addr = "0.0.0.0"
-iex "netsh interface portproxy delete v4tov4 listenaddress=$Addr listenport=$port_num | Out-Null";
-if ($Args[0] -ne "delete") {
-    iex "netsh interface portproxy add v4tov4 listenaddress=$Addr listenport=$port_num connectaddress=$WSL connectport=$port_num | Out-Null";
-}
-
-
-# Display all portproxy information
-netsh interface portproxy show v4tov4;
-
-# Give user to chance to see above list when relaunched start
-If ($Args[0] -eq "runas" -Or $Args[1] -eq "runas") {
-  Write-Host -NoNewLine 'Press any key to close! ';
-  $null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown');
-}

machineconfig/scripts/windows/wsl_ssh_windows_port_forwarding.ps1

@@ -1,76 +0,0 @@
-
-# https://gist.github.com/daehahn/497fa04c0156b1a762c70ff3f9f7edae?WT.mc_id=-blog-scottha
-# https://www.hanselman.com/blog/how-to-ssh-into-wsl2-on-windows-10-from-an-external-machine
-# https://learn.microsoft.com/en-us/windows/wsl/networking#accessing-a-wsl-2-distribution-from-your-local-area-network-lan
-# https://www.youtube.com/watch?v=PFI0IQZ9Z2I
-
-# WSL2 network port forwarding script v1
-#   for enable script, 'Set-ExecutionPolicy -ExecutionPolicy Bypass -Scope CurrentUser' in Powershell,
-#   for delete exist rules and ports use 'delete' as parameter, for show ports use 'list' as parameter.
-#   written by Daehyuk Ahn, Aug-1-2020
-
-Param($p = 2223)
-$port_num = $p
-
-#If ($Args[0] -eq $null) {
-#    $port_num = 2222;
-#    exit;
-#}
-#else {
-#    $port_num = $Args[0];
-#}
-# Display all portproxy information
-
-
-If ($Args[0] -eq "list") {
-    netsh interface portproxy show v4tov4;
-    exit;
-}
-
-wsl.exe -u root service ssh start  # added by me, to ensure sshd is fired.
-wsl.exe -u root service ssh status
-
-
-# If elevation needed, start new process
-If (-NOT ([Security.Principal.WindowsPrincipal] [Security.Principal.WindowsIdentity]::GetCurrent()).IsInRole([Security.Principal.WindowsBuiltInRole]::Administrator))
-{
-  # Relaunch as an elevated process:
-  Start-Process powershell.exe "-File",('"{0}"' -f $MyInvocation.MyCommand.Path),"$Args runas" -Verb RunAs
-  exit
-}
-
-# You should modify '$Ports' for your applications
-$Ports = ($port_num)  # (22,80,443,8080)
-
-# Check WSL ip address
-wsl hostname -I | Set-Variable -Name "WSL"
-$found = $WSL -match '\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}';
-if (-not $found) {
-  echo "WSL2 cannot be found. Terminate script.";
-  exit;
-}
-
-# Remove and Create NetFireWallRule
-Remove-NetFireWallRule -DisplayName 'WSL 2 Firewall Unlock';
-if ($Args[0] -ne "delete") {
-  New-NetFirewallRule -DisplayName 'WSL 2 Firewall Unlock' -Direction Outbound -LocalPort $Ports -Action Allow -Protocol TCP;
-  New-NetFirewallRule -DisplayName 'WSL 2 Firewall Unlock' -Direction Inbound -LocalPort $Ports -Action Allow -Protocol TCP;
-}
-
-# Add each port into portproxy
-$Addr = "0.0.0.0"
-Foreach ($Port in $Ports) {
-    iex "netsh interface portproxy delete v4tov4 listenaddress=$Addr listenport=$Port | Out-Null";
-    if ($Args[0] -ne "delete") {
-        iex "netsh interface portproxy add v4tov4 listenaddress=$Addr listenport=$Port connectaddress=$WSL connectport=$Port | Out-Null";
-    }
-}
-
-# Display all portproxy information
-netsh interface portproxy show v4tov4;
-
-# Give user to chance to see above list when relaunched start
-If ($Args[0] -eq "runas" -Or $Args[1] -eq "runas") {
-    Write-Host -NoNewLine 'Press any key to close! ';
-    $null = $Host.UI.RawUI.ReadKey('NoEcho,IncludeKeyDown');
-}

machineconfig/settings/lf/linux/exe/fzf_nano.sh

@@ -1,16 +0,0 @@
-#!/bin/sh
-# 🔍 Fuzzy Finder with Nano Editor Integration
-
-# 📝 Open selected file in nano
-nano (~/scripts/fzf2g)  # space used for precedence in execution
-
-# 💡 Alternative commands (commented):
-# 🔎 FZF with bat preview:
-# fzf --ansi --preview-window 'right:60%' --preview 'bat --color=always --style=numbers,grid,header --line-range :300 {}'
-
-# 🪟 Windows Git Bash version:
-# & "C:\Program Files\Git\usr\bin\nano.exe" (fzf --ansi --preview-window 'right:60%' --preview 'bat --color=always --style=numbers,grid,header --line-range :300 {}')
-
-# 📜 PowerShell script integration:
-# fzf | ~/scripts/nano.ps1
-

machineconfig/setup_linux/others/openssh-server_add_pub_key.sh

@@ -1,57 +0,0 @@
-#!/usr/bin/bash
-#=======================================================================
-# 🔑 SSH PUBLIC KEY AUTHENTICATION SETUP
-#=======================================================================
-# This script helps set up passwordless SSH authentication to remote Linux machines
-
-echo """#=======================================================================
-ℹ️ PASSWORDLESS SSH SETUP | Manual instructions for key deployment
-#=======================================================================
-"""
-
-echo """🔐 There are two methods to copy your public key to a remote server:
-
-📌 METHOD 1: Using ssh-copy-id (Linux clients only)
-   ssh-copy-id username@hostname
-
-📌 METHOD 2: Manual process (For Windows clients)
-   Windows PowerShell command:
-   type $env:USERPROFILE\.ssh\id_rsa.pub | ssh username@hostname "cat >> .ssh/authorized_keys"
-
-📌 METHOD 3: Using SFTP (detailed below)
-"""
-
-echo """#=======================================================================
-📋 MANUAL SFTP PROCESS | Step-by-step instructions
-#=======================================================================
-
-1️⃣ Connect to the server via SFTP (you'll need to enter password once):
-   sftp username@hostname
-
-2️⃣ Create .ssh directory on remote server if it doesn't exist:
-   mkdir -p .ssh
-
-3️⃣ Navigate to the .ssh directory:
-   cd .ssh
-
-4️⃣ Upload your public key:
-   put /path/to/your/local/id_rsa.pub
-
-5️⃣ Exit SFTP:
-   exit
-
-6️⃣ SSH to the server (password required this one last time):
-   ssh username@hostname
-
-7️⃣ Append the public key to authorized_keys:
-   cat ~/.ssh/id_rsa.pub >> ~/.ssh/authorized_keys
-
-8️⃣ Set proper permissions:
-   chmod 600 ~/.ssh/authorized_keys
-   chmod 700 ~/.ssh
-
-9️⃣ Test the connection in a new terminal (should not ask for password)
-"""
-
-# Note: This script contains instructions only - you need to manually follow the steps
-# replacing 'username@hostname' with your actual username and server hostname

machineconfig/setup_linux/web_shortcuts/croshell.sh

@@ -1,11 +0,0 @@
-#!/usr/bin/bash
-
-curl bit.ly/cfgvelinux -L | bash
-curl bit.ly/cfgreposlinux -L | bash
-
-cd $HOME/code/machineconfig
-$HOME/.local/bin/uv sync --no-dev
-$HOME/.local/bin/uv pip install -e ../crocodile
-
-uv run --no-dev --project $HOME/code/machineconfig -m fire machineconfig.profile.create main --choice=all
-. ~/.bashrc

machineconfig/setup_linux/web_shortcuts/ssh.sh

@@ -1,52 +0,0 @@
-#!/usr/bin/bash
-
-echo """#=======================================================================
-🔑 SSH KEY SETUP | Configuring SSH public key authentication
-#=======================================================================
-"""
-
-if [ -z "$pubkey_url" ]; then
-  echo """  🔍 No public key URL specified, using default GitHub URL
-  🔗 URL: https://github.com/thisismygitrepo.keys
-  """
-  pubkey_url='https://github.com/thisismygitrepo.keys'  # (CHANGE APPROPRIATELY)
-fi
-
-if [ -z "$pubkey_string" ]; then
-   echo """   📥 Fetching public key from URL...
-   """
-   export pubkey_string=$(curl --silent $pubkey_url)
-fi
-
-echo """#=======================================================================
-🛠️  SSH SERVER INSTALLATION | Standard SSH setup
-#=======================================================================
-
-Setting up OpenSSH server...
-"""
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/openssh_all.sh | sudo bash
-
-echo """#=======================================================================
-🔄 WSL CONFIGURATION | Additional WSL-specific setup
-#=======================================================================
-"""
-
-# For WSL only, also run the following:
-if [ -z "$port" ]; then
-  echo """  🔌 No port specified, using default port 2222
-  """
-  export port=2222
-fi
-
-echo """📡 Setting up WSL-specific SSH configuration on port $port...
-"""
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/openssh_wsl.sh | sudo bash
-
-echo """#=======================================================================
-✅ SETUP COMPLETE | SSH server configured successfully
-#=======================================================================
-
-🔒 SSH server is now ready to use
-🔑 Authorized key has been configured
-🔌 For WSL: Server configured to run on port $port
-"""

machineconfig/setup_windows/web_shortcuts/all.ps1

@@ -1,18 +0,0 @@
-
-# apps
-# Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/apps.ps1 | Invoke-Expression
-# virtual enviornment
-# Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/ve.ps1 | Invoke-Expression
-(iwr bit.ly/cfgvewindows).Content | iex
-
-# pwsh profile
-$machineconfig = (& "$HOME\code\machineconfig\.venv\Scripts\python.exe" -c "print(__import__('machineconfig').__file__[:-12])")
-# . $machineconfig/setup_windows/wt_and_pwsh.ps1  # experimental
-# OR: python -c "from machineconfig.setup_windows.wt_and_pwsh.setup_pwsh_theme import install_nerd_fonts; install_nerd_fonts()"
-
-# & "$HOME\code\machineconfig\.venv\Scripts\activate.ps1"
-# python -m fire machineconfig.profile.create_hardlinks main --choice=all
-# deactivate
-
-# devapps:
-. "$machineconfig\setup_windows\devapps.ps1"

machineconfig/setup_windows/web_shortcuts/ascii_art.ps1

@@ -1,36 +0,0 @@
-
-
-# below, check if npm is installed @ C:\Program Files\nodejs\npm
-if (Test-Path -Path "C:\Program Files\nodejs\npm") {
-    Write-Output "npm already installed ✅"
-} else {
-    winget install --Id CoreyButler.NVMforWindows --source winget --scope user
-}
-
-
-# test path ~/AppData/Roaming/npm/lolcatjs then install if not found
-if (Test-Path -Path "~/AppData/Roaming/npm/lolcatjs") {  # may be ensure that utility.cmd is available
-    Write-Output "lolcatjs already installed ✅"
-} else {
-    # install nodejs
-    npm install -g lolcatjs  # -g is essential to have cli utility as well as js library.
-}
-
-
-# install figlet if not found
-if (Test-Path -Path "~/AppData/Roaming/npm/figlet") {  # may be ensure that utility.cmd is available
-    # all good
-} else {
-    Write-Output "figlet already installed ✅"
-    npm install -g figlet-cli  # -g is essential to have cli utility as well as js library.
-}
-
-
-# install boxes if not found
-if (Test-Path -Path "~/AppData/Local/Microsoft/WindowsApps/boxes.exe") {  # may be ensure that utility.cmd is available
-    Write-Output "boxes already installed ✅"
-} else {
-    . "$env:USERPROFILE\code\machineconfig\.venv\Scripts\Activate.ps1"
-    python -m fire machineconfig.jobs.python_windows_installers.boxes main
-    deactivate
-}

machineconfig/setup_windows/web_shortcuts/croshell.ps1

@@ -1,16 +0,0 @@
-
-# with admin prviliage, run this in order to minimally install croshell.
-
-# virtual enviornment
-# Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/ve.ps1 | Invoke-Expression
-(iwr bit.ly/cfgvewindows).Content | iex
-
-# dev repos
-# Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/repos.ps1 | Invoke-Expression
-(iwr bit.ly/cfgreposwindows).Content | iex
-
-# symlinks
-. $HOME/code/machineconfig/src/machineconfig/setup_windows/symlinks.ps1
-
-# windows terminal and powershell
-(iwr bit.ly/cfgwt).Content | iex

machineconfig/setup_windows/web_shortcuts/ssh.ps1

@@ -1,11 +0,0 @@
-
-# NOT INTENDED FOR PUBLIC USE. 
-
-if (!$pubkey_string) {
-    $pubkey_url = 'https://github.com/thisismygitrepo.keys'  # (CHANGE APPROPRIATELY)
-    $pubkey_string = (Invoke-WebRequest $pubkey_url).Content
-} else {
-    Write-Output "pubkey_string is already defined."
-}
-
-Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/openssh_all.ps1 | Invoke-Expression

machineconfig/utils/ai/generate_file_checklist.py

@@ -1,68 +0,0 @@
-#!/usr/bin/env python
-
-from pathlib import Path
-from typing import List, Optional, Union, Annotated
-from rich.console import Console
-from rich.panel import Panel
-
-import typer
-
-def generate_file_checklist(repo_root: Union[str, Path], exclude_dirs: Optional[List[str]] = None) -> Path:
-    actual_exclude_dirs: List[str] = [".venv", ".git", "__pycache__", "build", "dist", "*.egg-info"]
-    if exclude_dirs is not None:
-        actual_exclude_dirs = exclude_dirs
-    repo_root = Path(repo_root).expanduser().absolute()
-    output_path: Path = repo_root / ".ai" / "repo_task" / "file_checklist.md"
-    py_files: List[Path] = []
-    for filepath in repo_root.glob("**/*.py"):
-        if any(excl in filepath.parts for excl in actual_exclude_dirs) or any(filepath.match(f"**/{excl}/**") for excl in actual_exclude_dirs) or filepath.name == "__init__.py":
-            continue
-        py_files.append(filepath.relative_to(repo_root))
-
-    sh_files: List[Path] = []
-    for filepath in repo_root.glob("**/*.sh"):
-        if any(excl in filepath.parts for excl in actual_exclude_dirs) or any(filepath.match(f"**/{excl}/**") for excl in actual_exclude_dirs):
-            continue
-        sh_files.append(filepath.relative_to(repo_root))
-
-    py_files.sort()
-    sh_files.sort()
-
-    markdown_content: str = "# File Checklist\n\n"
-
-    markdown_content += "## Python Files\n\n"
-    for py_file in py_files:
-        markdown_content += f"- [ ] {py_file}\n"
-
-    markdown_content += "\n## Shell Script Files\n\n"
-    for sh_file in sh_files:
-        markdown_content += f"- [ ] {sh_file}\n"
-    Path(output_path).parent.mkdir(parents=True, exist_ok=True)
-    Path(output_path).write_text(markdown_content, encoding="utf-8")
-
-    print(f"📋 Checklist generated at: {output_path}")
-    return output_path
-def main(
-    repo: Annotated[str, typer.Argument(help="Repository root path. Defaults to current working directory.")] = str(Path.cwd()),
-    exclude: Annotated[Optional[List[str]], typer.Option("--exclude", "-e", help="Additional directories to exclude (by default excludes .venv, .git, __pycache__, build, dist, *.egg-info)")] = None,
-) -> None:
-    exclude_dirs: List[str] = [".venv", ".git", "__pycache__", "build", "dist", "*.egg-info"]
-    if exclude:
-        exclude_dirs.extend(exclude)
-    if repo == "":
-        print("Error: Repository path cannot be empty.")
-        return
-
-    output_path = generate_file_checklist(repo, exclude_dirs)
-    console = Console()
-    console.print(Panel(f"✅ SUCCESS | Markdown checklist generated successfully!\n📄 File Location: {output_path}", border_style="bold blue", expand=False))
-
-
-def main_from_parser():
-    typer.run(main)
-
-
-
-
-if __name__ == "__main__":
-    main_from_parser()

machineconfig-5.15.dist-info/METADATA

@@ -1,188 +0,0 @@
-Metadata-Version: 2.4
-Name: machineconfig
-Version: 5.15
-Summary: Dotfiles management package
-Author-email: Alex Al-Saffar <programmer@usa.com>
-License: Apache 2.0
-Project-URL: Homepage, https://github.com/thisismygitrepo/machineconfig
-Project-URL: Bug Tracker, https://github.com/thisismygitrepo/machineconfig/issues
-Classifier: Programming Language :: Python :: 3
-Classifier: License :: OSI Approved :: Apache Software License
-Classifier: Operating System :: OS Independent
-Requires-Python: >=3.13
-Description-Content-Type: text/markdown
-Requires-Dist: cryptography>=44.0.2
-Requires-Dist: fire>=0.7.0
-Requires-Dist: joblib>=1.5.2
-Requires-Dist: paramiko>=3.5.1
-Requires-Dist: randomname>=0.2.1
-Requires-Dist: requests>=2.32.5
-Requires-Dist: rich>=14.0.0
-Requires-Dist: tenacity>=9.1.2
-Requires-Dist: psutil>=7.0.0
-Requires-Dist: gitpython>=3.1.44
-Requires-Dist: pyfzf>=0.3.1
-Requires-Dist: rclone-python>=0.1.23
-Requires-Dist: pyjson5>=1.6.9
-Requires-Dist: typer-slim>=0.19.2
-Requires-Dist: questionary>=2.1.1
-Requires-Dist: typer>=0.19.2
-Provides-Extra: windows
-Requires-Dist: pywin32; extra == "windows"
-Provides-Extra: docs
-Requires-Dist: pdoc>=15.0.2; extra == "docs"
-
-
-<p align="center">
-
-<a href="https://github.com/thisismygitrepo/machineconfig/commits">
-<img src="https://img.shields.io/github/commit-activity/m/thisismygitrepo/machineconfig" />
-</a>
-
-</p>
-
-
-# Welcome to machineconfig
-
-# Shortcuts
-* `bit.ly/cfgroot` is a shortcut to this repo.
-* `glow https://bit.ly/cfgread` OR `curl bit.ly/cfgread -L | bat -l md --style="header"` to get the readme file.
-
-Machineconfig is a package for managing configuration files (aka dotfiles). The idea is to collect those critical, time-consuming-files-to-setup in one directory and reference them via symbolic links from their original locations. Thus, when a new machine is to be setup, all that is required is to clone the repo in that machine and create the symbolic links.
-Dotfiles include, but are not limited to:
-* `~/.gitconfig`
-* `~/.ssh`
-* `~/.aws`
-* `~/.bash_profile`
-* `~/.bashrc`
-* `~/.config`
-* `$profile` in Windows Powershell
-* etc
-
-
-Additionally, files that contain data, sensitive information that should not be pushed to a repository are contained in a directory `~/dotfiles`. The files therein are encrypted before backedup.
-
-
-## Windows Setup
-With elevated `PowerShell`, run the following: (short `curl bit.ly/cfgallwindows -L | iex`)
-
-**You have to have `winget` first. If its not available in the your terminal, try those resources:**
-
-* https://github.com/asheroto/winget-install
-* https://github.com/microsoft/winget-cli
-* https://github.com/microsoft/winget-cli/discussions/3258
-
-
-```shell
-# apps  # short: `(iwr bit.ly/cfgappswindows).Content | iex`
-Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/apps.ps1 | Invoke-Expression
-# virtual enviornment  # short (iwr bit.ly/cfgvewindows).Content | iex OR `curl bit.ly/cfgvewindows -L | iex`
-Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/ve.ps1 | Invoke-Expression
-# symlinks # short `(iwr bit.ly/cfgsymlinkswindows).Content | iex` OR `curl bit.ly/cfgsymlinkswindows -L | iex`
-. $HOME/code/machineconfig/src/machineconfig/setup_windows/symlinks.ps1
-# devapps:
-$HOME/code/machineconfig/src/machineconfig/setup_windows/devapps.ps1
-# pwsh and wt settings: (iwr bit.ly/cfgwt).Content | iex
-iwr https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/wt_and_pwsh.ps1 | iex
-
-```
-
-```shell
-
-(iwr bit.ly/cfgappswindows).Content | iex
-(iwr bit.ly/cfgvewindows).Content | iex
-. $HOME/code/machineconfig/src/machineconfig/setup_windows/devapps.ps1
-(iwr bit.ly/cfgwt).Content | iex
-. $HOME/code/machineconfig/src/machineconfig/setup_windows/symlinks.ps1
-
-& "$HOME\code\machineconfig\.venv\Scripts\activate.ps1"
-python -m fire machineconfig.profile.create main2 --choice=all
-deactivate
-
-```
-
-###### Setup SSH connection:
-```shell
-# CHANGE pubkey_string APPROPRIATELY
-$pubkey_string=(Invoke-WebRequest 'https://github.com/thisismygitrepo.keys').Content
-Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/openssh_all.ps1 | Invoke-Expression
-```
-short `(iwr bit.ly/cfgsshwindows).Content | iex` OR `curl bit.ly/cfgsshwindows -L | iex`
-
-###### Install Croshell Terminal Directly,
-```shell
-Invoke-WebRequest https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_windows/web_shortcuts/croshell.ps1 | Invoke-Expression
-```
-short: `curl bit.ly/cfgcroshellwindows -L | iex` OR `(iwr bit.ly/cfgcroshellwindows).Content | iex`
-
-
-# Linux Setup
-With `sudo` access, run the following: (short `curl bit.ly/cfgalllinux -L | bash`)
-```bash
-export package_manager="nala"
-export package_manager="nix"
-
-# apps  # short: `curl bit.ly/cfgappslinux -L | bash`
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/apps.sh | bash
-# Optionally: curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/apps_dev.sh | bash
-
-# virtual enviornment  # short `curl bit.ly/cfgvelinux -L | bash`
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/ve.sh | bash
-
-# repos  # short `curl bit.ly/cfgreposlinux -L | bash`
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/repos.sh | bash
-# symlinks and bash profile: # short `curl bit.ly/cfgsymlinkslinux -L | bash`
-source ~/code/machineconfig/src/machineconfig/setup_linux/symlinks.sh  # requires sudo since it invloves chmod of dotfiles/.ssh, however sudo doesn't work with source. best to have sudo -s earlier.
-
-# devapps
-source <(sudo cat ~/code/machineconfig/src/machineconfig/setup_linux/devapps.sh)
-```
-
-###### Setup SSH connection:
-```bash
-pubkey_url='https://github.com/thisismygitrepo.keys'  # (CHANGE APPROPRIATELY)
-export pubkey_string=$(curl --silent $pubkey_url)
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/openssh_all.sh | sudo bash
-# For WSL only, also run the following:
-export port=2223
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/openssh_wsl.sh | sudo bash
-# don't forget to run `wsl_ssh_windows_port_forwarding -p 2223` from Windows using the designated port with
-```
-short `curl bit.ly/cfgsshlinux -L | bash`
-
-
-###### Install Croshell Terminal Directly
-
-```bash
-
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/web_shortcuts/croshell.sh | sudo bash
-
-```
-short `curl bit.ly/cfgcroshelllinux -L | bash`
-
-
-## Repository management CLI
-
-The DevOps CLI now exposes rich subcommands for working with git repositories. Run `python -m machineconfig.scripts.python.devops repos --help` to explore the hierarchy:
-
-* Top-level actions: `push`, `pull`, `commit`, `all`, and `analyze`.
-	* These commands accept `--recursive/-r` and `--no-sync` to control nested repos and automatic `uv sync`.
-* Sync workflows live under `sync`:
-	* `record` captures the current machine state into a `repos.json`.
-	* `capture` clones repos from a specification without changing commits.
-	* `checkout` aligns repositories to commits stored in the spec.
-	* `checkout-to-branch` switches repositories to the tracked branch.
-	* Each sync subcommand accepts `--cloud/-c` for fetching/saving specs from remote storage.
-
-Example:
-
-```bash
-python -m machineconfig.scripts.python.devops repos sync record ~/code --cloud my_remote
-python -m machineconfig.scripts.python.devops repos pull ~/code --recursive
-```
-
-# Author
-Alex Al-Saffar. [email](mailto:programmer@usa.com)
-
-[![Alex's github activity graph](https://github-readme-activity-graph.vercel.app/graph?username=thisismygitrepo)](https://github.com/ashutosh00710/github-readme-activity-graph)
-