krasavacode 0.2.1 → 0.2.2

package/README.md

@@ -1,85 +1,94 @@
 # KRASAVACODE
 
-Однокнопочный бесплатный вайбкодинг на Claude Code — для учеников.
+Бесплатный вайбкодинг через ИИ. Ставится двумя кликами, без регистрации, без карты.
 
-## Установка и запуск
+---
 
-### Вариант А — у меня есть Node.js
+## 🍏 У меня Mac
 
-```bash
-npx krasavacode
-```
+**Шаг 1.** Скачай файл-установщик:
 
-Всё. Pollinations работает без логина и без карты. Если у тебя Node старее 20 — наш CLI сам подтянет нужную версию.
+➡️ **[install-mac.command](https://github.com/alexrexby/krasavacode/raw/main/install-mac.command)**
 
-### Вариант Б — у меня нет ничего
+(нажмёшь — он сразу скачается в папку «Загрузки»)
 
-Скачай готовый бинарник из последнего релиза:
-**https://github.com/alexrexby/krasavacode/releases/latest**
+**Шаг 2.** Открой папку «Загрузки» (значок Finder в Dock → слева **Загрузки**).
 
-| Твоя ОС | Файл |
-|---|---|
-| Windows | `krasavacode.exe` |
-| macOS Apple Silicon (M1/M2/M3/M4) | `krasavacode-mac-arm64` |
-| macOS Intel | `krasavacode-mac-x64` |
-| Linux x64 | `krasavacode-linux-x64` |
+**Шаг 3.** Нажми **правой кнопкой мыши** на файл `install-mac.command` → в меню выбери **«Открыть»** → в появившемся окне ещё раз **«Открыть»**.
 
-После скачивания — открой терминал в папке со скачанным файлом и запусти:
+> ⚠️ Почему правой кнопкой? Файл от незнакомого автора, и macOS первый раз спрашивает разрешения. Через правую кнопку → «Открыть» macOS даст согласие. На обычный дабл-клик — заблокирует.
 
-**Windows:**
-```
-krasavacode.exe
-```
-Если выскочит «Windows protected your PC» → жми **More info** → **Run anyway**.
+**Шаг 4.** Откроется чёрное окно (это нормально — это Терминал). Жди ≈ минуту, оно само скачает программу. В конце нажми **Enter**.
 
-**macOS:**
-```bash
-chmod +x krasavacode-mac-arm64
-xattr -d com.apple.quarantine krasavacode-mac-arm64   # снимает блок Gatekeeper
-./krasavacode-mac-arm64
-```
+**Шаг 5.** На Рабочем столе появился значок **«ВАЙБКОДИНГ»**. Дабл-клик — и пиши задачу обычным языком: «сделай мне сайт-визитку», «напиши игру в крестики-нолики», что угодно.
 
-**Linux:**
-```bash
-chmod +x krasavacode-linux-x64
-./krasavacode-linux-x64
-```
+---
 
-При первом запуске бинарник скачает Node.js и Claude Code в `~/.krasavacode/` (≈100 МБ, один раз). Дальше — мгновенно.
+## 🪟 У меня Windows
 
-## Если хочется моделей помощнее
+**Шаг 1.** Скачай файл-установщик:
 
-```bash
-npx krasavacode upgrade
-```
+➡️ **[install-windows.bat](https://github.com/alexrexby/krasavacode/raw/main/install-windows.bat)**
+
+(нажмёшь — он сразу скачается в папку «Загрузки». Если Edge спросит «оставить или отменить», нажми **«Сохранить»**)
+
+**Шаг 2.** Открой папку **Загрузки** (Проводник → Загрузки слева).
+
+**Шаг 3.** Дабл-клик на файл `install-windows.bat`.
 
-Откроется дашборд OmniRoute в браузере. Подключи одним кликом:
-- **Kiro AI** — Claude Sonnet/Haiku через AWS Builder ID
-- **Qoder** — Kimi K2 / Qwen3-Coder / DeepSeek-R1
-- **Qwen Code** — 4 модели Alibaba
-- **LongCat** — 50M токенов в день
+> ⚠️ Если Windows покажет синее окно **«Windows protected your PC»** — нажми **More info** (или «Подробнее»), потом **Run anyway** (или «Выполнить в любом случае»). Файл безопасный, но без платной подписи Windows показывает это окно всегда.
 
-Всё бесплатно, без карты.
+**Шаг 4.** Откроется чёрное окно (это Командная строка). Жди ≈ минуту, оно само скачает программу. В конце нажми **любую клавишу**.
 
-## Если что-то не работает
+**Шаг 5.** На Рабочем столе появился значок **«ВАЙБКОДИНГ»**. Дабл-клик — и пиши задачу.
+
+---
+
+## 🐧 Linux
 
 ```bash
-npx krasavacode doctor
+curl -L https://github.com/alexrexby/krasavacode/releases/latest/download/krasavacode-linux-x64 -o ~/krasavacode
+chmod +x ~/krasavacode
+~/krasavacode
 ```
 
-Покажет что сломано. Самые частые проблемы:
-- **Корпоративный прокси / Россия / Китай** → запусти upgrade и в дашборде включи SOCKS5
-- **Порт 3456 занят** → перезапусти терминал
+---
 
-## Что под капотом
+## Что писать в окне «ВАЙБКОДИНГ»
 
+Что угодно своими словами:
+
+- «Сделай простой сайт обо мне с моими увлечениями»
+- «Напиши на Python калькулятор подоходного налога»
+- «Создай игру Тетрис на одной HTML-странице»
+- «Объясни, что такое API, как для пятиклассника»
+
+Программа сама напишет код, файлы, структуру проекта. Если не знаешь, что делать дальше — просто спроси её: **«а что мне дальше делать?»**.
+
+---
+
+## Что-то пошло не так?
+
+| Проблема | Что делать |
+|---|---|
+| Mac пишет «не может быть открыт» | Жми **правой кнопкой** → **Открыть** → **Открыть**. Не дабл-клик. |
+| Windows пишет «protected your PC» | Жми **More info** → **Run anyway**. |
+| Окно сразу закрылось | Перетащи файл `install-mac.command` или `install-windows.bat` в Терминал/cmd и нажми Enter — увидишь сообщение об ошибке. |
+| Долго качает | Установщик тащит ≈100 МБ — нужен интернет. На медленных соединениях может занять 5–10 минут. |
+| Ошибка про блокировку Pollinations / 429 | Подожди минуту и попробуй снова — это бесплатный сервис, у него лимиты. Или `npx krasavacode upgrade` для подключения других моделей. |
+
+---
+
+## Для тех, кто знает, что такое терминал
+
+```bash
+npx krasavacode
 ```
-krasavacode  →  claude-code-router (порт 3456)  →  Pollinations
-                (Anthropic ↔ OpenAI bridge)        (free, no API key)
-```
 
-CLI = `@anthropic-ai/claude-code` с подменённым `ANTHROPIC_BASE_URL`. Все обновления Claude Code от Anthropic прилетают автоматом.
+Работает на любой ОС с Node.js 20+. Если Node старше 20 или вообще нет — CLI сам подтянет нужный. Источники: https://github.com/alexrexby/krasavacode
+
+---
 
 ## Лицензия
 
-MIT. Pollinations / Kiro AI / Qoder / другие провайдеры имеют свои ToS — читай их условия.
+MIT. Под капотом: [@anthropic-ai/claude-code](https://www.npmjs.com/package/@anthropic-ai/claude-code) + [@musistudio/claude-code-router](https://www.npmjs.com/package/@musistudio/claude-code-router) + [Pollinations](https://pollinations.ai). Их условия использования — на их сайтах.

package/bin/krasavacode.js

@@ -7,7 +7,7 @@ import { runUpgrade } from '../src/upgrade.js';
 import { runDoctor } from '../src/doctor.js';
 
 // Hardcoded so it works inside Bun --compile (no FS access to package.json)
-const VERSION = '0.2.1';
+const VERSION = '0.2.2';
 
 const cmd = process.argv[2];
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "krasavacode",
-  "version": "0.2.1",
+  "version": "0.2.2",
   "description": "KRASAVACODE — однокнопочный бесплатный вайбкодинг для учеников. Claude Code на бесплатных провайдерах через локальный gateway. Сам ставит Node при необходимости.",
   "type": "module",
   "bin": {