📢 Це Free-core OSS-mirror під ліцензією MIT. Pro-функції (статистика, експорт історії, backup/restore, switch-model хоткей, premium prompt packs) — у платній версії, яка розповсюджується як єдиний інсталятор з capybro.app.

Цей репозиторій містить повну Free-tier функціональність CapyBro v2.0 — все, що потрібно для базового щоденного використання.

CapyBro — це Windows tray-утиліта, що пускає AI у вашу повсякденну роботу з текстом без жодного зайвого кроку.

Виділили текст у Word, Chrome, VS Code, Slack, Notepad — будь-де → натиснули глобальний хоткей (Ctrl+Shift+E за замовчуванням) → AI переписав за вашим промтом → новий текст уже стоїть на місці виділеного. Ніяких вкладок браузера, copy-paste у ChatGPT і назад, ніяких ручних промптів щоразу.

Працює офлайн-як-можливо: один HTTPS-запит до OpenRouter (десятки моделей через єдиний акаунт — GPT-4o, Claude, Gemini, Llama, etc), решта — локально. Native .NET 8 / WPF, без браузера, без Electron. Сидить у системному треї і прокидається тільки на ваш хоткей.

Чому "CapyBro"? Капібара — найхалявніша і найдружніша тварина. Вона нікуди не поспішає, всім допомагає, і ладнає з усіма. Утиліта, яка тихо сидить поруч і робить нудну роботу замість вас — саме той вайб.

• ✨ Що вміє (Free)
• 💎 Що дає Pro
• ⌨ Гарячі клавіші
• 📥 Установка для користувачів
• 🪟 Інтерфейс
• ⚙ Налаштування
• 🔁 Скидання до дефолтів
• 🔐 Приватність і безпека
• ❓ FAQ / Troubleshooting
• 🚀 Швидкий старт для розробників
• 🧩 Архітектура та tech stack
• 🤝 Contributing
• 📜 Ліцензія

• Глобальний хоткей (Ctrl+Shift+E за замовчуванням): виділили текст у Word / Chrome / VS Code / куди завгодно → натиснули → AI переписав за вашим стандартним промтом → готовий результат уже в документі. Працює над будь-якою програмою, що підтримує copy-paste.
• Меню промтів (Ctrl+Shift+Q): toast зі списком ваших промтів. Стрілки/Enter для вибору, Esc для скасування, цифри 1-9 як швидкий доступ.
• Undo (Ctrl+Shift+Z): миттєво відкочує останню заміну до оригінального тексту. Працює навіть якщо історія вимкнена.
• Кастомні промти: створюйте/редагуйте необмежено своїх сценаріїв. Кожен промт може мати власну модель (override default), окремо для OpenRouter і Ollama, флаг "зберегти мову оригіналу", власну температуру / max tokens, прев'ю різниці перед застосуванням.

• Історія покращень (за замовчуванням увімкнено): останні 50 запусків — оригінал / результат / промт / модель / час. Пошук, групування по бакетах дат (Сьогодні / Вчора / Цього тижня / Раніше), copy original / copy improved / delete entry, Clear all. Можна вимкнути в Налаштуваннях → Додаткові функції.
• Diff preview (опціональний модал): side-by-side порівняння оригіналу + результату з підсвічуванням змін через DiffPlex. Accept / Regenerate / Reject.
• Тостове сповіщення з потоковим відображенням генерації (streaming) — видно як AI типує. Кнопка ✕ скасовує запит миттєво.

Два бекенди, переключаються однією галочкою у Налаштуваннях → Провайдер:

• OpenRouter (хмара, за замовчуванням) — швидко, широкий вибір моделей (GPT-4o, Claude, Gemini, Llama тощо), pay-as-you-go. Потрібен API-ключ з openrouter.ai/keys.
• Ollama (локально) — для тих, хто категорично не хоче відправляти текст у хмару. Запустіть ollama, завантажте будь-яку модель (ollama pull gemma3), натисніть «Оновити моделі» — увесь pipeline працює офлайн.

Окремо для кожного провайдера зберігаються: поточна модель, список pinned моделей, per-request таймаут (60 с / 120 с), per-prompt override. Перемикання OpenRouter ↔ Ollama жоден набір не губить. Авто-перемикання на OpenRouter, якщо Ollama зникає — програма виявляє при наступній взаємодії і ставить червоний toast → зелений confirmation через 2.5 с, persisted на диск.

• 3 мови UI: Українська, Російська, English. Перемикається мить-в-мить.
• Темна тема + custom WindowChrome caption.
• Уніфіковане Cut/Copy/Paste context-menu у всіх text-input полях.
• Pixel-smooth scroll у списках.
• Стійкість до конфліктів буфера обміну (clipboard manager, RDP, антивірус).
• Автозапуск з Windows (опційно).
• Onboarding-візард з 4 кроків при першому запуску (Welcome + Language → API-ключ → хоткеї ×ばつ 3 → Done).

Усі під чекбоксами у Налаштуваннях → Додаткові функції:

• Privacy redaction: авто-маскування PII (email, телефони, картки, IBAN, ПІБ) перед відправкою у модель. Текст відновлюється після відповіді. OpenRouter-only.
• Cost estimator: показує приблизну вартість запиту до OpenRouter + поточний баланс. OpenRouter-only.
• Per-prompt model: для кожного промту окрема модель.
• Налаштовуваний таймаут запиту: 0 = безкінечний.

Pro — одноразова покупка 19ドル на capybro.app, розблоковує 5 фіч поверх Free:

Купити: capybro.app/#pricing. Одноразова покупка через Gumroad (19ドル). 3 пристрої на ключ. 14 днів гарантії повернення коштів.

Усі хоткеї реєструються через Win32 RegisterHotKey з MOD_NOREPEAT, тому працюють глобально поверх будь-якої програми. Конфлікти з системними / іншими утилітами визначаються одразу: onboarding-візард і Налаштування → Загальне підсвічують конфліктний хоткей червоним.

Підписана збірка, автоматичні оновлення через Windows Update, нативна підтримка x64 + ARM64. Поточна версія у Store — 2.0.1 з autostart-фіксом.

Один рядок у PowerShell або терміналі — winget завантажить і встановить сам:

winget install RomanTykhonenko.CapyBro

Скачайте файл CapyBro-Setup-2.0.0.exe (~49 MB) з GitHub Releases або з capybro.app. Інсталятор per-user — НЕ потребує адмін-прав, ставить у %LOCALAPPDATA%\CapyBro\.

SmartScreen попередження (тільки для .exe-маршруту): інсталятор зараз непідписаний, тому Windows покаже "Невідомий видавець". Натисніть "Додатково" → "Все одно виконати". У Microsoft Store-збірці цього вікна немає — Microsoft підписує її своїм сертифікатом.

Запустіть інсталятор → майстер у 3 кліки → готово. Іконка з'явиться у системному треї біля годинника.

Запуститься onboarding-візард з 4 кроків:

1. Welcome + UI Language — короткий інтро та селектор мови (English / Українська / Русский) з live-preview.
2. API-ключ OpenRouter — поле з openrouter.ai/keys. 400 мс debounce → автоматична /credits валідація. Можна пропустити і потім перемкнутись на Ollama.
3. Хоткеї — три поля (Improve / Menu / Undo) з виявленням конфліктів.
4. Done — підсумок як користуватись.

«Пропустити» зберігає лише прапор OnboardingCompleted=true, решта полів залишається дефолтною — можна заповнити пізніше у Налаштуваннях. «Готово» записує все, що ви ввели.

Tray-іконка → Settings → вкладка Промти. Створіть кілька промтів під свої сценарії.

Іконка-капібара у системному треї біля годинника. Tooltip: CapyBro (OpenRouter) або CapyBro · Ollama. Між запусками хоткея у застосунку немає головного вікна — все доступно через трей.

• Лівий клік на іконці → відкриває Settings.
• Правий клік на іконці → контекстне меню: Налаштування / Історія / Вийти. «Вийти» — graceful shutdown (flush pending writes, cancel in-flight HTTP).

Sidebar з вкладками:

У footer-і sidebar: v2.0.0 · capybro.app (клікабельний) + (якщо Ollama) outline-pill Ollama.

Файл: %USERPROFILE%\.ai_text_improver_v2_config.json (schema v20)

• Провайдер — checkbox Use local model (Ollama). Видимий тільки коли ollama serve запущений.
• Профіль — мова UI, API-ключ OpenRouter, дефолтна модель + ModelsDialog для каталога.
• Local models (Ollama) — endpoint, model picker, refresh (видима тільки коли Ollama активна).
• Гарячі клавіші — Improve / Menu / Undo (3 ComboBox-и з custom-input).
• Система — checkbox Запускати з Windows.
• Додаткові функції — 6 чекбоксів (Diff preview, Streaming, Per-prompt model, Cost & credits [OR-only], Privacy redaction [OR-only], History) + Timeout TextBox.
• Danger zone — Скинути налаштування.

З v14 значення 0 у полі Request timeout — це валідний sentinel "чекати скільки треба". TextProcessor перекладає 0 → Timeout.InfiniteTimeSpan перед передачею у клієнт. Зовнішнє скасування (user Cancel, OnExit) все ще працює.

🎯 Усе робиться через кнопки в UI. Файли руками видаляти не потрібно.

Settings → General → пролистати донизу → Danger zone → «Скинути налаштування» → ConfirmDialog → YES.

Що відбувається:

• Config wipes до дефолтних значень
• API-ключ видаляється з Windows Credential Manager
• General + Prompts tabs reload з диску

Чого Reset НЕ робить (навмисно): не чіпає ~/.ai_text_improver_v2_history.json (окрема кнопка Settings → History → Clear all), не чіпає Run-key автозапуску у HKCU (вимикається через Settings → System → uncheck «Запускати з Windows»), не чіпає файл логу.

Reset НЕ повертає OnboardingWizard — прапор OnboardingCompleted=true присутній в AppConfig.Default. Якщо потрібно: закрити застосунок → відкрити ~/.ai_text_improver_v2_config.json у редакторі → змінити "OnboardingCompleted": true на false → перезапустити.

CapyBro по-замовчуванню збирає ZERO телеметрії — жодних analytics, crash reporting, опитувань. Усі мережеві запити — це лише ваші запити до OpenRouter (один HTTPS-call на хоткей). Більше нічого нікуди не йде.

Інваріант: snake_case префікси .ai_text_improver_v2_* навмисно НЕ перейменовано при brand-rename AITextImprover → CapyBro (2026年05月12日) — це би осиротило всі існуючі v1 установки.

Опція Налаштування → Додаткові функції → Маскування PII автоматично замінює перед відправкою у модель: email → <<EMAIL_n>>, телефони → <<PHONE_n>>, URLs → <<URL_n>>, кредитні картки → <<CARD_n>>, IBAN → <<IBAN_n>>, ПІБ → <<NAME_n>>. Після відповіді AI оригінальні значення підставляються назад — модель ніколи не бачить реальних PII. Implementation: Services/PrivacyRedactor.cs + регресійні тести.

1. Перевірте, чи цей хоткей не зайнятий іншою утилітою (Snipping Tool Ctrl+Shift+S часто конфліктує).
2. Налаштування → Загальне → блок «Гарячі клавіші». Конфлікт підсвічується червоним.
3. Змініть на щось унікальне типу Ctrl+Alt+Shift+E.

Відкрийте промт у Налаштування → Промти і перепишіть його експліцитніше («Виправ помилки тією ж мовою, не перекладай»). Модель робить те, що каже промт.

• Перевірте, чи у цільовій програмі є фокус на текстовому полі. CapyBro вставляє через clipboard + Ctrl+V.
• Деякі sandbox'овані додатки (UWP / WSA) блокують keyboard automation. Результат уже у вашому clipboard — вставте Ctrl+V вручну.

Натисніть Ctrl+Shift+Z одразу після нежеданого результату. CapyBro поверне оригінал з in-memory кешу (або з історії).

Інсталятор зараз непідписаний (SmartScreen accumulation period). Сейф — «Додатково» → «Все одно виконати».

• Іконка у треї повинна бути жива. Якщо сіра — додаток впав. Перезапустіть з Start menu.
• Лог: %USERPROFILE%\.ai_text_improver_v2*.log — там stack trace.

Так, мінімум — Windows 10 1809. Mica → solid background на старіших.

Ні. Залежить від Win32 API (RegisterHotKey, SendInput, Credential Manager, NotifyIcon).

# Клонувати
git clone https://github.com/phantasmat2018/capy-bro.git
cd capy-bro
# Запустити з-під dotnet (Debug)
dotnet run --project src/CapyBro
# Тести
dotnet test
# Self-contained збірка
dotnet publish src/CapyBro -c Release -r win-x64 --self-contained -p:PublishReadyToRun=true -o publish/win-x64
# NSIS installer (потрібен makensis у PATH або у `Program Files (x86)\NSIS\Bin\`)
& "C:\Program Files (x86)\NSIS\Bin\makensis.exe" installer\installer.nsi
# → installer/CapyBro-Setup-2.0.0.exe

Кожен коміт має проходити три перевірки:

dotnet format --verify-no-changes # стиль коду
dotnet build -warnaserror # 0 warnings
dotnet test # regression tests

Усі троє мають бути зеленими — non-negotiable.

• Не запускайте dotnet build поки CapyBro.exe у треї — DLL заблокована running процесом. Перед збіркою: taskkill /F /IM CapyBro.exe /IM testhost.exe /IM dotnet.exe.
• InternalsVisibleTo для тестів — CapyBro.Tests має доступ до internal-методів через атрибут у csproj.
• Translator parity invariant — будь-який новий ключ перекладу мусить бути в усіх 3 локалях (UA/RU/EN).

capy-bro/
├── src/CapyBro/ # WPF додаток
│ ├── App.xaml(.cs) # entry point, DI host, error handlers
│ ├── Models/ # AppConfig (schema v20), HistoryEntry, Prompt, ...
│ ├── Services/ # ConfigStore, HotkeyManager, OpenRouterClient,
│ │ # OllamaClient, TextProcessor, HistoryStore,
│ │ # AutostartService, Translator, ToastPresenter,
│ │ # PrivacyRedactor, ...
│ ├── ViewModels/ # GeneralTabVM, PromptsTabVM, HistoryVM, ...
│ ├── Views/ # XAML вікна
│ ├── Controls/ # WindowCaption, RevealablePasswordBox, ...
│ ├── Themes/ # Кольори, типографія, віджет-стилі
│ ├── Platform/ # SingleInstance + Win32 P/Invoke
│ └── Services/Migration/ # Legacy v1 → v2 config migration
├── tests/CapyBro.Tests/ # xUnit
├── installer/ # NSIS-script + sign-installer.ps1
├── assets/ # logo.ico, logo.png, header.png
└── README.md # цей файл

Pull requests welcome! Зверніть увагу:

1. Quality gate non-negotiable — dotnet format --verify-no-changes, dotnet build -warnaserror, dotnet test мають бути зеленими.
2. Translator parity — нові рядки потребують переклад у всі 3 локалі (UA/RU/EN) одразу.
3. Тести assertion-by-value — Assert.Equal(expected, actual) на user-intent slots, не It.IsAny<>.
4. Жодних коментарів типу «WHAT does this code do» — тільки WHY non-obvious.
5. Жодних emoji у коді (тільки у документації як ця).
6. Issues + bug reports — у GitHub Issues.

Pro-функції не приймаються через PR у цей репо (вони у платній закритій версії). Якщо ваша зміна — це Free-tier фіча або фікс, додавайте.

MIT License © 2026 Roman Tykhonenko.

Pro-версія (з статистикою, експортом, switch-model хоткеєм, premium prompt packs, backup/restore) розповсюджується окремо як платний product на capybro.app і не покривається MIT-ліцензією цього репо.