machineconfig 3.3__py3-none-any.whl → 3.5__py3-none-any.whl

machineconfig/cluster/sessions_managers/wt_local_manager.py

@@ -6,7 +6,7 @@ import logging
 import subprocess
 from pathlib import Path
 from typing import Optional, Dict, List, Any
-from machineconfig.utils.utils5 import Scheduler
+from machineconfig.utils.scheduler import Scheduler
 from machineconfig.cluster.sessions_managers.wt_local import WTLayoutGenerator
 from machineconfig.utils.schemas.layouts.layout_types import LayoutConfig
 

machineconfig/cluster/sessions_managers/wt_remote_manager.py

@@ -4,7 +4,7 @@ import uuid
 import logging
 from pathlib import Path
 from typing import Optional, Any
-from machineconfig.utils.utils5 import Scheduler
+from machineconfig.utils.scheduler import Scheduler
 from machineconfig.cluster.sessions_managers.wt_local import run_command_in_wt_tab
 from machineconfig.cluster.sessions_managers.wt_remote import WTRemoteLayoutGenerator
 from machineconfig.utils.schemas.layouts.layout_types import TabConfig

machineconfig/cluster/sessions_managers/zellij_local_manager.py

@@ -11,7 +11,7 @@ from typing import Optional, List
 from rich.console import Console
 
 from machineconfig.cluster.sessions_managers.zellij_utils.monitoring_types import SessionReport, GlobalSummary, StartResult, ActiveSessionInfo, StatusRow
-from machineconfig.utils.utils5 import Scheduler
+from machineconfig.utils.scheduler import Scheduler
 from machineconfig.cluster.sessions_managers.zellij_local import ZellijLayoutGenerator
 from machineconfig.utils.schemas.layouts.layout_types import LayoutConfig
 

machineconfig/cluster/sessions_managers/zellij_remote_manager.py

@@ -3,7 +3,7 @@ import json
 import uuid
 from pathlib import Path
 from typing import Optional, Dict
-from machineconfig.utils.utils5 import Scheduler
+from machineconfig.utils.scheduler import Scheduler
 from machineconfig.cluster.sessions_managers.zellij_local import run_command_in_zellij_tab
 from machineconfig.cluster.sessions_managers.zellij_remote import ZellijRemoteLayoutGenerator
 from machineconfig.utils.schemas.layouts.layout_types import LayoutConfig

machineconfig/cluster/templates/utils.py

@@ -1,5 +1,5 @@
 from typing import Optional
-from machineconfig.utils.path_reduced import PathExtended, PLike
+from machineconfig.utils.path_extended import PathExtended, PLike
 
 
 def to_cloud(

machineconfig/jobs/linux/msc/cli_agents.sh

@@ -1,12 +1,15 @@
 #!/bin/bash
 
 
+# Terminal-based CLI agents and tools for productivity and coding.
 npm install -g @google/gemini-cli
 npm install -g @charmland/crush
-npm install -g opencode-ai@latest
+npm install -g opencode-ai@latest  # or curl -fsSL https://opencode.ai/install | bash
+uv tool install --force --python python3.12 --with pip aider-chat@latest
 
-curl https://cursor.com/install -fsS | bash
 
+# cursor-cli
+curl https://cursor.com/install -fsS | bash
 cd $HOME/Downloads
 curl --proto '=https' --tlsv1.2 -sSf "https://desktop-release.q.us-east-1.amazonaws.com/latest/q-x86_64-linux.zip" -o "q.zip"
 unzip q.zip
@@ -14,3 +17,16 @@ unzip q.zip
 rm q.zip
 rm -rfd q
 
+# Vscode extensions for AI-assisted coding.
+# Github copilot
+# Roo
+# Cline
+# Kilocode
+# Continue
+# CodeGPT
+# qodo (and cli)
+
+# Editors based on AI
+# Kiro
+# Cursor
+

machineconfig/jobs/python/python_ve_symlink.py

@@ -1,6 +1,6 @@
 """Symlinks"""
 
-from machineconfig.utils.path_reduced import PathExtended as PathExtended
+from machineconfig.utils.path_extended import PathExtended as PathExtended
 # from machineconfig.utils.utils import display_options
 
 

machineconfig/jobs/python/vscode/api.py

@@ -1,5 +1,5 @@
 from pathlib import Path
-from machineconfig.utils.utils2 import randstr
+from machineconfig.utils.accessories import randstr
 
 
 def open_file_in_new_instance(file_path: str):

machineconfig/jobs/python/vscode/select_interpreter.py

@@ -3,8 +3,8 @@
 # import os
 # import json
 from pathlib import Path
-from machineconfig.utils.io_save import save_json
-from machineconfig.utils.utils2 import read_json
+from machineconfig.utils.io import save_json
+from machineconfig.utils.io import read_json
 import argparse
 import platform
 

machineconfig/jobs/python/vscode/sync_code.py

@@ -1,6 +1,6 @@
 from pathlib import Path
 from configparser import SectionProxy
-from machineconfig.utils.utils2 import read_ini
+from machineconfig.utils.io import read_ini
 
 config = read_ini(Path.home().joinpath(".ssh", "config"))
 

machineconfig/jobs/python_custom_installers/dev/bypass_paywall.py

@@ -3,7 +3,7 @@
 # from platform import system
 from typing import Optional
 from machineconfig.utils.schemas.installer.installer_types import InstallerData
-from machineconfig.utils.path_reduced import PathExtended as PathExtended
+from machineconfig.utils.path_extended import PathExtended as PathExtended
 
 
 config_dict: InstallerData = {

machineconfig/jobs/python_custom_installers/dev/espanso.py

@@ -68,7 +68,7 @@ def main(version: Optional[str]):
     print("🚀 Installing Espanso using installer...")
     from machineconfig.utils.installer_utils.installer_class import Installer
 
-    installer = Installer.from_dict(config_dict, name="espanso")
+    installer = Installer(config_dict)
     installer.install(version=None)
 
     config = """

machineconfig/jobs/python_custom_installers/hx.py

@@ -2,7 +2,7 @@
 Installers do not add runtime files to the machine, hence this script.
 """
 
-from machineconfig.utils.path_reduced import PathExtended as PathExtended
+from machineconfig.utils.path_extended import PathExtended as PathExtended
 from machineconfig.utils.installer_utils.installer_abc import WINDOWS_INSTALL_PATH
 from typing import Optional
 import platform

machineconfig/jobs/python_generic_installers/config.json

@@ -366,17 +366,6 @@
       "stripVersion": true,
       "exeName": "mprocs"
     },
-    {
-      "appName": "opencommit",
-      "repoURL": "npm install -g opencommit",
-      "doc": "📝 Opencommit is a cli tool to help you write better commit messages.",
-      "filenameTemplate": {
-        "amd64": {},
-        "arm64": {}
-      },
-      "stripVersion": false,
-      "exeName": "opencommit"
-    },
     {
       "appName": "ouch",
       "repoURL": "https://github.com/ouch-org/ouch",

machineconfig/profile/create.py

@@ -6,17 +6,17 @@ This script Takes away all config files from the computer, place them in one dir
 
 from rich.console import Console
 
-from machineconfig.utils.path_reduced import PathExtended as PathExtended
+from machineconfig.utils.path_extended import PathExtended as PathExtended
 from machineconfig.utils.links import symlink_func, symlink_copy
 from machineconfig.utils.options import display_options
 from machineconfig.utils.source_of_truth import LIBRARY_ROOT, REPO_ROOT
-from machineconfig.utils.utils2 import read_toml
 from machineconfig.profile.shell import create_default_shell_profile
 
 import platform
 import os
 import ctypes
 import subprocess
+import tomllib
 from typing import Optional, Any, TypedDict
 
 system = platform.system()  # Linux or Windows
@@ -39,7 +39,7 @@ class SymlinkMapper(TypedDict):
 
 
 def apply_mapper(choice: Optional[str] = None):
-    symlink_mapper: dict[str, dict[str, SymlinkMapper]] = read_toml(LIBRARY_ROOT.joinpath("profile/mapper.toml"))
+    symlink_mapper: dict[str, dict[str, SymlinkMapper]] = tomllib.loads(LIBRARY_ROOT.joinpath("profile/mapper.toml").read_text(encoding="utf-8"))
     prioritize_to_this = True
     exclude: list[str] = []  # "wsl_linux", "wsl_windows"
 

machineconfig/profile/shell.py

@@ -1,6 +1,6 @@
 """shell"""
 
-from machineconfig.utils.path_reduced import PathExtended as PathExtended
+from machineconfig.utils.path_extended import PathExtended as PathExtended
 from machineconfig.utils.source_of_truth import LIBRARY_ROOT
 
 import platform

machineconfig/scripts/python/ai/mcinit.py

@@ -1,17 +1,16 @@
 from pathlib import Path
-from machineconfig.utils.ve import get_repo_root
 
-installations = """
-uv add --upgrade-package pylint pyright mypy pyrefly ty --dev  # linters and type checkers
-uv add --upgrade-package pytest --dev
-"""
+from machineconfig.scripts.python.ai.solutions import generic
+from machineconfig.scripts.python.ai.solutions.claude import claude
+from machineconfig.scripts.python.ai.solutions.cline import cline
+from machineconfig.scripts.python.ai.solutions.copilot import github_copilot
+from machineconfig.scripts.python.ai.solutions.crush import crush
+from machineconfig.scripts.python.ai.solutions.cursor import cursors
+from machineconfig.scripts.python.ai.solutions.gemini import gemini
+from machineconfig.utils.accessories import get_repo_root
 
 
 def add_ai_configs(repo_root: Path) -> None:
-    import machineconfig as mc
-
-    mc_root = Path(mc.__file__).parent
-
     repo_root_resolved = get_repo_root(repo_root)
     if repo_root_resolved is not None:
         repo_root = repo_root_resolved  # this means you can run the command from any subdirectory of the repo.
@@ -22,6 +21,9 @@ def add_ai_configs(repo_root: Path) -> None:
             command_to_run = """
 uv init --python 3.13
 uv venv
+uv add --upgrade-package pylint pyright mypy pyrefly ty --dev  # linters and type checkers
+uv add --upgrade-package pytest --dev
+
 """
             import subprocess
 
@@ -30,66 +32,20 @@ uv venv
             print("Terminating mcinit ...")
             return
 
-    instructions_repository_dir = mc_root.joinpath("scripts/python/ai/instructions")
-    chatmodes_dir = mc_root.joinpath("scripts/python/ai/chatmodes")
-    prompts_dir = mc_root.joinpath("scripts/python/ai/prompts")
-    # python_rules_file = instructions_repository_dir.joinpath("python/dev.md")
-
-    # VSCODE:
-    # as per: https://docs.github.com/en/copilot/how-tos/configure-custom-instructions/add-repository-instructions
-    # Copilot Chat on github website chat & basic guideline.
-    repo_root.joinpath(".github/chatmodes").mkdir(parents=True, exist_ok=True)
-    repo_root.joinpath(".github/prompts").mkdir(parents=True, exist_ok=True)
-    repo_root.joinpath(".github/instructions").mkdir(parents=True, exist_ok=True)
-    for a_chatmode in chatmodes_dir.iterdir():
-        repo_root.joinpath(".github/chatmodes", a_chatmode.name.split(".")[0] + ".chatmode.md").write_text(data=a_chatmode.read_text(encoding="utf-8"), encoding="utf-8")
-    for a_prompt in prompts_dir.iterdir():
-        repo_root.joinpath(".github/prompts", a_prompt.name.split(".")[0] + ".prompt.md").write_text(data=a_prompt.read_text(encoding="utf-8"), encoding="utf-8")
-    for an_instruction in instructions_repository_dir.rglob("*.md"):
-        repo_root.joinpath(".github/instructions", an_instruction.name.split(".")[0] + ".instruction.md").write_text(data=an_instruction.read_text(encoding="utf-8"), encoding="utf-8")
-    tmp = repo_root.joinpath(".github/copilot-instructions.md")
-
-    generic_instructions = instructions_repository_dir.joinpath("python/dev.instructions.md")
-    tmp.write_text(data=generic_instructions.read_text(encoding="utf-8"), encoding="utf-8")
-
-    # CURSOR, GEMINI, CLAUDE CODE, CRUSH, CLINE.
-    tmp = repo_root.joinpath(".cursor/rules/python_dev.mdc")
-    tmp.parent.mkdir(parents=True, exist_ok=True)
-    tmp.write_text(data=generic_instructions.read_text(encoding="utf-8"), encoding="utf-8")
-    tmp = repo_root.joinpath("CLAUDE.md")
-    tmp.write_text(data=generic_instructions.read_text(encoding="utf-8"), encoding="utf-8")
-    tmp = repo_root.joinpath("CRUSH.md")
-    tmp.write_text(data=generic_instructions.read_text(encoding="utf-8"), encoding="utf-8")
-
-    tmp = repo_root.joinpath("GEMINI.md")
-    tmp.write_text(data=generic_instructions.read_text(encoding="utf-8"), encoding="utf-8")
-    gemini_settings = mc_root.joinpath("scripts/python/ai/configs/.gemini/settings.json")
-    repo_root.joinpath(".gemini").mkdir(parents=True, exist_ok=True)
-    repo_root.joinpath(".gemini/settings.json").write_text(data=gemini_settings.read_text(encoding="utf-8"), encoding="utf-8")
-
-    tmp = repo_root.joinpath(".clinerules")
-    tmp.mkdir(parents=True, exist_ok=True)
-    tmp.joinpath("python_dev.md").write_text(data=generic_instructions.read_text(encoding="utf-8"), encoding="utf-8")
-
-    # OTHERS
-    scripts_dir = mc_root.joinpath("scripts/python/ai/scripts")
-    repo_root.joinpath(".scripts").mkdir(parents=True, exist_ok=True)
-    for a_script in scripts_dir.iterdir():
-        repo_root.joinpath(".scripts", a_script.name).write_text(data=a_script.read_text(encoding="utf-8"), encoding="utf-8")
-
     dot_ai_dir = repo_root.joinpath(".ai")
     dot_ai_dir.mkdir(parents=True, exist_ok=True)
-    dot_git_ignore_path = repo_root.joinpath(".gitignore")
-    if dot_git_ignore_path.exists():
-        dot_git_ignore_content = dot_git_ignore_path.read_text(encoding="utf-8")
-        to_add: list[str] = []
-        to_check_for: list[str] = [".links", "notebooks", ".ai", ".scripts", "GEMINI.md", "CLAUDE.md", ".cursor", ".github/instructions", ".github/chatmodes", ".github/prompts"]
-        for item in to_check_for:
-            if item not in dot_git_ignore_content:
-                to_add.append(item)
-        # if "*.ipynb"
-        if len(to_add) > 0:
-            dot_git_ignore_path.write_text(data=dot_git_ignore_content + "\n" + "\n".join(to_add), encoding="utf-8")
+    dot_scripts_dir = repo_root.joinpath(".scripts")
+    dot_scripts_dir.mkdir(parents=True, exist_ok=True)
+    generic.create_dot_scripts(repo_root=repo_root)
+    generic.adjust_gitignore(repo_root=repo_root)
+
+    github_copilot.build_configuration(repo_root=repo_root)
+    cursors.build_configuration(repo_root=repo_root)
+    gemini.build_configuration(repo_root=repo_root)
+    claude.build_configuration(repo_root=repo_root)
+    crush.build_configuration(repo_root=repo_root)
+    cline.build_configuration(repo_root=repo_root)
+
 
 
 def main() -> None:

machineconfig/scripts/python/ai/solutions/_shared.py

@@ -0,0 +1,5 @@
+from pathlib import Path
+from machineconfig.utils.source_of_truth import LIBRARY_ROOT
+
+def get_generic_instructions_path() -> Path:
+    return LIBRARY_ROOT.joinpath("scripts/python/ai/solutions/copilot/instructions/python/dev.instructions.md")

machineconfig/scripts/python/ai/solutions/claude/claude.py

@@ -0,0 +1,8 @@
+from pathlib import Path
+
+from machineconfig.scripts.python.ai.solutions._shared import get_generic_instructions_path
+
+
+def build_configuration(repo_root: Path) -> None:
+    instructions_path = get_generic_instructions_path()
+    repo_root.joinpath("CLAUDE.md").write_text(data=instructions_path.read_text(encoding="utf-8"), encoding="utf-8")

machineconfig/scripts/python/ai/solutions/cline/cline.py

@@ -0,0 +1,10 @@
+from pathlib import Path
+
+from machineconfig.scripts.python.ai.solutions._shared import get_generic_instructions_path
+
+
+def build_configuration(repo_root: Path) -> None:
+    instructions_path = get_generic_instructions_path()
+    cline_dir = repo_root.joinpath(".clinerules")
+    cline_dir.mkdir(parents=True, exist_ok=True)
+    cline_dir.joinpath("python_dev.md").write_text(data=instructions_path.read_text(encoding="utf-8"), encoding="utf-8")

machineconfig/scripts/python/ai/solutions/copilot/github_copilot.py

@@ -0,0 +1,35 @@
+from pathlib import Path
+
+from machineconfig.scripts.python.ai.solutions._shared import get_generic_instructions_path
+from machineconfig.utils.source_of_truth import LIBRARY_ROOT
+
+
+
+def build_configuration(repo_root: Path) -> None:
+    instructions_repository_dir = LIBRARY_ROOT.joinpath("scripts/python/ai/solutions/copilot/instructions")
+    chatmodes_dir = LIBRARY_ROOT.joinpath("scripts/python/ai/solutions/copilot/chatmodes")
+    prompts_dir = LIBRARY_ROOT.joinpath("scripts/python/ai/solutions/copilot/prompts")
+
+    github_dir = repo_root.joinpath(".github")
+    chatmodes_target_dir = github_dir.joinpath("chatmodes")
+    prompts_target_dir = github_dir.joinpath("prompts")
+    instructions_target_dir = github_dir.joinpath("instructions")
+
+    chatmodes_target_dir.mkdir(parents=True, exist_ok=True)
+    prompts_target_dir.mkdir(parents=True, exist_ok=True)
+    instructions_target_dir.mkdir(parents=True, exist_ok=True)
+
+    for chatmode in chatmodes_dir.iterdir():
+        chatmode_target = chatmodes_target_dir.joinpath(f"{chatmode.name.split('.')[0]}.chatmode.md")
+        chatmode_target.write_text(data=chatmode.read_text(encoding="utf-8"), encoding="utf-8")
+
+    for prompt in prompts_dir.iterdir():
+        prompt_target = prompts_target_dir.joinpath(f"{prompt.name.split('.')[0]}.prompt.md")
+        prompt_target.write_text(data=prompt.read_text(encoding="utf-8"), encoding="utf-8")
+
+    for instruction in instructions_repository_dir.rglob("*.md"):
+        instruction_target = instructions_target_dir.joinpath(f"{instruction.name.split('.')[0]}.instruction.md")
+        instruction_target.write_text(data=instruction.read_text(encoding="utf-8"), encoding="utf-8")
+
+    generic_instructions_path = get_generic_instructions_path()
+    github_dir.joinpath("copilot-instructions.md").write_text(data=generic_instructions_path.read_text(encoding="utf-8"), encoding="utf-8")

machineconfig/scripts/python/ai/solutions/copilot/privacy.md

@@ -0,0 +1,4 @@
+
+# Go to settings of github copilot and disable telemetry usage and report
+# simliarly, disable using data for training.
+# remember to do this per account.

machineconfig/scripts/python/ai/solutions/crush/crush.json

@@ -0,0 +1,216 @@
+{
+  "$schema": "https://charm.land/crush.json",
+  "providers": {
+    "openai": {
+      "id": "openai",
+      "name": "OpenAI",
+      "base_url": "https://api.openai.com/v1",
+      "type": "openai",
+      "api_key": "$OPENAI_API_KEY",
+      "extra_headers": {
+        "OpenAI-Beta": "assistants=v2"
+      },
+      "models": [
+        {
+          "id": "gpt-4o",
+          "name": "GPT-4o",
+          "cost_per_1m_in": 5,
+          "cost_per_1m_out": 15,
+          "cost_per_1m_in_cached": 1,
+          "cost_per_1m_out_cached": 3,
+          "context_window": 128000,
+          "default_max_tokens": 16384,
+          "can_reason": false,
+          "has_reasoning_efforts": false,
+          "supports_attachments": true
+        },
+        {
+          "id": "gpt-4o-mini",
+          "name": "GPT-4o mini",
+          "cost_per_1m_in": 0.15,
+          "cost_per_1m_out": 0.6,
+          "cost_per_1m_in_cached": 0.05,
+          "cost_per_1m_out_cached": 0.2,
+          "context_window": 128000,
+          "default_max_tokens": 8192,
+          "can_reason": false,
+          "has_reasoning_efforts": false,
+          "supports_attachments": true
+        }
+      ]
+    },
+    "anthropic": {
+      "id": "anthropic",
+      "name": "Anthropic",
+      "base_url": "https://api.anthropic.com/v1",
+      "type": "anthropic",
+      "api_key": "$ANTHROPIC_API_KEY",
+      "extra_headers": {
+        "anthropic-version": "2023-06-01"
+      },
+      "models": [
+        {
+          "id": "claude-3-5-sonnet-20240620",
+          "name": "Claude 3.5 Sonnet",
+          "cost_per_1m_in": 3,
+          "cost_per_1m_out": 15,
+          "cost_per_1m_in_cached": 3.75,
+          "cost_per_1m_out_cached": 0.3,
+          "context_window": 200000,
+          "default_max_tokens": 8000,
+          "can_reason": true,
+          "has_reasoning_efforts": true,
+          "default_reasoning_effort": "medium",
+          "supports_attachments": true
+        },
+        {
+          "id": "claude-3-haiku-20240307",
+          "name": "Claude 3 Haiku",
+          "cost_per_1m_in": 0.25,
+          "cost_per_1m_out": 1.25,
+          "cost_per_1m_in_cached": 0.05,
+          "cost_per_1m_out_cached": 0.1,
+          "context_window": 200000,
+          "default_max_tokens": 4000,
+          "can_reason": true,
+          "has_reasoning_efforts": true,
+          "default_reasoning_effort": "low",
+          "supports_attachments": true
+        }
+      ]
+    },
+    "openrouter": {
+      "id": "openrouter",
+      "name": "OpenRouter",
+      "base_url": "https://openrouter.ai/api/v1",
+      "type": "openai",
+      "api_key": "$OPENROUTER_API_KEY",
+      "models": [
+        {
+          "id": "deepseek/deepseek-chat",
+          "name": "Deepseek V3",
+          "cost_per_1m_in": 0.27,
+          "cost_per_1m_out": 1.1,
+          "cost_per_1m_in_cached": 0.07,
+          "cost_per_1m_out_cached": 0.3,
+          "context_window": 64000,
+          "default_max_tokens": 5000,
+          "can_reason": true,
+          "has_reasoning_efforts": false,
+          "supports_attachments": false
+        }
+      ]
+    },
+    "ollama": {
+      "id": "ollama",
+      "name": "Ollama",
+      "base_url": "http://localhost:11434/v1/",
+      "type": "openai",
+      "models": [
+        {
+          "id": "qwen2.5-coder:14b",
+          "name": "Qwen2.5 Coder 14B",
+          "cost_per_1m_in": 0,
+          "cost_per_1m_out": 0,
+          "cost_per_1m_in_cached": 0,
+          "cost_per_1m_out_cached": 0,
+          "context_window": 32768,
+          "default_max_tokens": 4096,
+          "can_reason": false,
+          "has_reasoning_efforts": false,
+          "supports_attachments": false
+        }
+      ]
+    }
+  },
+  "models": {
+    "large": {
+      "provider": "anthropic",
+      "model": "claude-3-5-sonnet-20240620",
+      "think": true,
+      "max_tokens": 6000
+    },
+    "small": {
+      "provider": "openai",
+      "model": "gpt-4o-mini",
+      "max_tokens": 4096
+    }
+  },
+  "lsp": {
+    "python": {
+      "command": "pyright-langserver",
+      "args": ["--stdio"],
+      "filetypes": ["py"],
+      "env": {
+        "PYRIGHT_PYTHON_FORCE_VERSION": "3.13"
+      }
+    },
+    "ruff": {
+      "command": "ruff",
+      "args": ["server"],
+      "filetypes": ["py"]
+    },
+    "json": {
+      "command": "vscode-json-languageserver",
+      "args": ["--stdio"]
+    }
+  },
+  "mcp": {
+    "filesystem": {
+      "type": "stdio",
+      "command": "uv",
+      "args": [
+        "run",
+        "python",
+        "-m",
+        "machineconfig.scripts.python.ai.solutions._shared"
+      ],
+      "timeout": 120,
+      "env": {
+        "UV_PROJECT_ENV": "$(pwd)"
+      }
+    },
+    "github-docs": {
+      "type": "http",
+      "url": "https://api.github.com/mcp/",
+      "timeout": 90,
+      "headers": {
+        "Authorization": "$(echo Bearer $GITHUB_MCP_TOKEN)",
+        "X-Crush-Client": "machineconfig"
+      }
+    },
+    "architect": {
+      "type": "sse",
+      "url": "https://architect.mcp.machineconfig.local/stream",
+      "timeout": 120,
+      "headers": {
+        "Authorization": "$(echo Bearer $ARCHITECT_MCP_TOKEN)"
+      }
+    }
+  },
+  "options": {
+    "context_paths": [
+      "CRUSH.md",
+      "src/machineconfig/scripts/python/ai/solutions/crush/privacy.md",
+      ".github/copilot-instructions.md",
+      "src/machineconfig/scripts/python/ai/solutions/_shared.py"
+    ],
+    "tui": {
+      "compact_mode": true,
+      "diff_mode": "unified"
+    },
+    "debug": false,
+    "debug_lsp": false,
+    "disable_auto_summarize": false,
+    "data_directory": ".crush"
+  },
+  "permissions": {
+    "allowed_tools": [
+      "view",
+      "ls",
+      "glob",
+      "grep",
+      "write"
+    ]
+  }
+}

machineconfig/scripts/python/ai/solutions/crush/crush.py

@@ -0,0 +1,25 @@
+
+
+"""
+ref: https://github.com/charmbracelet/crush
+
+"""
+
+from pathlib import Path
+import platform
+from machineconfig.scripts.python.ai.solutions._shared import get_generic_instructions_path
+
+
+
+def build_configuration(repo_root: Path) -> None:
+    instructions_path = get_generic_instructions_path()
+    repo_root.joinpath("CRUSH.md").write_text(data=instructions_path.read_text(encoding="utf-8"), encoding="utf-8")
+
+    repo_settings = repo_root.joinpath(".crush.json")
+    ignore_settings = repo_root.joinpath(".crushignore")
+    if platform.system() == "Windows":
+        global_settings = Path.home().joinpath("AppData/Local/crush/crush.json")
+    else:
+        global_settings = Path.home().joinpath(".config/crush/crush.json")
+    
+    _ = repo_settings, ignore_settings, global_settings  # to avoid unused variable warnings

machineconfig/scripts/python/ai/solutions/crush/privacy.md

@@ -0,0 +1,2 @@
+
+docs don't mention at all anything about user code privacy, data collection or telemetry or any reporting.

machineconfig/scripts/python/ai/solutions/cursor/cursors.py

@@ -0,0 +1,10 @@
+from pathlib import Path
+
+from machineconfig.scripts.python.ai.solutions._shared import get_generic_instructions_path
+
+
+def build_configuration(repo_root: Path) -> None:
+    instructions_path = get_generic_instructions_path()
+    cursor_rules_path = repo_root.joinpath(".cursor/rules/python_dev.mdc")
+    cursor_rules_path.parent.mkdir(parents=True, exist_ok=True)
+    cursor_rules_path.write_text(data=instructions_path.read_text(encoding="utf-8"), encoding="utf-8")