Rules/README.md

Rules

Скрипты для Cursor rules, SSH и git remotes (kalinamall, home, github).

Быстро: что запускать

Ситуация	Windows	Mac / Linux
Новый комп (ничего не настроено)	Скопировать install.ps1 с рабочего ПК → запустить в каталоге проекта	То же с install.sh
Комп уже настраивали (~/CursorRules есть)	init-cursor в каталоге проекта	init-cursor
Только обновить rules	init-cursor -Update	init-cursor --update

Скрипты сами проверяют SSH, clone, ключи и remotes. Вручную выбирать SSH/HTTPS не нужно.

---

Новый компьютер

Нужен только git. Repo приватный — curl/irm по raw-URL не работают.

1. Скопировать один файл с рабочей машины

# Windows — с другого ПК (пример)
scp user@work-pc:CursorRules/install.ps1 $env:TEMP\

# Mac — с другого ПК
scp user@work-pc:CursorRules/install.sh /tmp/

USB, общая папка — тоже подходит.

2. Запустить в каталоге вашего проекта

# Windows
cd C:\path\to\your-repo
& $env:TEMP\install.ps1

# Mac
cd ~/projects/your-repo
bash /tmp/install.sh

Скрипт сам:

1. Клонирует Rules в ~/CursorRules (SSH → если не вышло, HTTPS с логином)
2. Настраивает SSH-ключи и Gitea API (если ещё нет)
3. Копирует rules в текущий проект, настраивает remotes
4. Добавляет init-cursor в профиль shell

---

Уже настроенный компьютер

cd C:\path\to\your-repo
init-cursor

cd ~/projects/your-repo
init-cursor

Если команда не найдена — один раз:

. $HOME\CursorRules\init-cursor.ps1   # Windows

source ~/CursorRules/init-cursor.sh   # Mac

---

Обновить rules / скрипты

init-cursor -Update          # Windows

init-cursor --update         # Mac

Обновит $HOME/CursorRules с Gitea и перекопирует rules в проект.

---

Git remotes (в каждом проекте)

Remote	Куда
kalinamall	git.kalinamall.ru
home	git.papatramp.ru
github	github.com/PTah

Push: git push kalinamall

---

Кодировка файлов (Windows / Linux)

Правило file-encoding (.cursor/rules/file-encoding.mdc, alwaysApply: true):

Среда	Расширения	Кодировка	Переносы
Windows / PowerShell	.ps1, .psm1	UTF-8 with BOM	CRLF
Linux / shell	.sh	UTF-8 без BOM	LF
Runtime JSON/spool (PS → SAC/API)	на диске	UTF-8 без BOM	—

В репозиториях проектов — .editorconfig и .gitattributes (шаблоны есть в этом repo).

После init-cursor --update правило попадает во все проекты.

---

Конфиги (local/)

Файл	Назначение
git-ssh-hosts.conf	SSH-хосты и ключи
git-user.conf	git user.name / email
kalinamall-gitea.conf	API kalinamall
papatramp-gitea.conf	API home Gitea

Подключения на новом ПК

Если SSH/Gitea/GitHub/LAN ещё не настроены — см. rule machine-connectivity-bootstrap и install.ps1 / install.sh.