krasavacode 0.2.0 → 0.2.2

package/README.md

@@ -1,64 +1,94 @@
 # KRASAVACODE
 
-Однокнопочный бесплатный вайбкодинг на Claude Code — для учеников.
+Бесплатный вайбкодинг через ИИ. Ставится двумя кликами, без регистрации, без карты.
 
-## Установка и запуск
+---
 
-**Один способ:**
+## 🍏 У меня Mac
 
-```bash
-npx krasavacode
-```
+**Шаг 1.** Скачай файл-установщик:
 
-Всё. Pollinations работает без логина и без карты, лимитов хватит на 2–5 учебных MVP.
+➡️ **[install-mac.command](https://github.com/alexrexby/krasavacode/raw/main/install-mac.command)**
 
-При первой команде ставится локальный gateway и Claude Code (один раз, ~30 сек). Потом запуск моментальный.
+(нажмёшь — он сразу скачается в папку «Загрузки»)
 
-## Если хочешь больше моделей
+**Шаг 2.** Открой папку «Загрузки» (значок Finder в Dock → слева **Загрузки**).
 
-```bash
-npx krasavacode upgrade
-```
+**Шаг 3.** Нажми **правой кнопкой мыши** на файл `install-mac.command` → в меню выбери **«Открыть»** → в появившемся окне ещё раз **«Открыть»**.
+
+> ⚠️ Почему правой кнопкой? Файл от незнакомого автора, и macOS первый раз спрашивает разрешения. Через правую кнопку → «Открыть» macOS даст согласие. На обычный дабл-клик — заблокирует.
+
+**Шаг 4.** Откроется чёрное окно (это нормально — это Терминал). Жди ≈ минуту, оно само скачает программу. В конце нажми **Enter**.
+
+**Шаг 5.** На Рабочем столе появился значок **«ВАЙБКОДИНГ»**. Дабл-клик — и пиши задачу обычным языком: «сделай мне сайт-визитку», «напиши игру в крестики-нолики», что угодно.
+
+---
+
+## 🪟 У меня Windows
+
+**Шаг 1.** Скачай файл-установщик:
+
+➡️ **[install-windows.bat](https://github.com/alexrexby/krasavacode/raw/main/install-windows.bat)**
+
+(нажмёшь — он сразу скачается в папку «Загрузки». Если Edge спросит «оставить или отменить», нажми **«Сохранить»**)
+
+**Шаг 2.** Открой папку **Загрузки** (Проводник → Загрузки слева).
 
-Откроется дашборд в браузере. Там одним кликом подключишь:
-- **Kiro AI** — Claude Sonnet/Haiku через AWS Builder ID
-- **Qoder** — Kimi K2 / Qwen3-Coder / DeepSeek-R1
-- **Qwen Code** — 4 модели Alibaba
-- **LongCat** — 50M токенов в день
+**Шаг 3.** Дабл-клик на файл `install-windows.bat`.
 
-Всё бесплатно, без карты.
+> ⚠️ Если 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
 ```
 
-Покажет, что сломано. Самые частые проблемы:
-- **Старый Node.js** → обнови до 20+ с https://nodejs.org
-- **Порт занят** → перезапусти терминал
-- **Корпоративный прокси/Россия/Китай** → запусти upgrade и в дашборде включи SOCKS5
+---
 
-## Что под капотом
+## Что писать в окне «ВАЙБКОДИНГ»
 
-```
-krasavacode  →  локальный OmniRoute  →  Pollinations / Kiro / Qoder / …
-                (free gateway, MIT)     (free providers без карты)
-```
+Что угодно своими словами:
+
+- «Сделай простой сайт обо мне с моими увлечениями»
+- «Напиши на Python калькулятор подоходного налога»
+- «Создай игру Тетрис на одной HTML-странице»
+- «Объясни, что такое API, как для пятиклассника»
+
+Программа сама напишет код, файлы, структуру проекта. Если не знаешь, что делать дальше — просто спроси её: **«а что мне дальше делать?»**.
 
-CLI = `@anthropic-ai/claude-code` с подменённым backend. Все обновления Claude Code от Anthropic прилетают автоматом.
+---
 
-## Бинарники без Node.js
+## Что-то пошло не так?
 
-Для уроков с непрофильными студентами — скачай готовый бинарник со страницы релиза:
-- `krasavacode.exe` (Windows)
-- `krasavacode-mac-arm64`, `krasavacode-mac-x64` (macOS)
-- `krasavacode-linux-x64` (Linux)
+| Проблема | Что делать |
+|---|---|
+| 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
+```
 
-Дабл-клик → откроется терминал с Claude Code. Node.js не нужен.
+Работает на любой ОС с Node.js 20+. Если Node старше 20 или вообще нет — CLI сам подтянет нужный. Источники: https://github.com/alexrexby/krasavacode
 
-> Замечание: бинарники тащат portable Node при первом запуске (~30 МБ, один раз). После — работают офлайн.
+---
 
 ## Лицензия
 
-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

@@ -6,18 +6,16 @@ import { launchClaude } from '../src/launch.js';
 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.2';
+
 const cmd = process.argv[2];
 
 async function main() {
   if (cmd === 'doctor') return runDoctor();
   if (cmd === 'upgrade') return runUpgrade();
   if (cmd === '--version' || cmd === '-v') {
-    const { readFile } = await import('node:fs/promises');
-    const { fileURLToPath } = await import('node:url');
-    const { dirname, join } = await import('node:path');
-    const here = dirname(fileURLToPath(import.meta.url));
-    const pkg = JSON.parse(await readFile(join(here, '..', 'package.json'), 'utf8'));
-    console.log(`KRASAVACODE v${pkg.version}`);
+    console.log(`KRASAVACODE v${VERSION}`);
     return;
   }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "krasavacode",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "KRASAVACODE — однокнопочный бесплатный вайбкодинг для учеников. Claude Code на бесплатных провайдерах через локальный gateway. Сам ставит Node при необходимости.",
   "type": "module",
   "bin": {
@@ -27,5 +27,13 @@
     "free",
     "education"
   ],
-  "license": "MIT"
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/alexrexby/krasavacode.git"
+  },
+  "homepage": "https://github.com/alexrexby/krasavacode#readme",
+  "bugs": {
+    "url": "https://github.com/alexrexby/krasavacode/issues"
+  }
 }