Cookie Code 🍪

English (full) · Русский · Русский (full)

Превратите DeepSeek в настоящего помощника по коду. Cookie Code соединяет AI-чат с вашей реальной кодовой базой — без API-токенов, без копипасты, только чистая автоматизация.

---

🎯 Зачем Cookie Code?

Проблема: DeepSeek умён, но слеп к вашему проекту. Он не может читать файлы, запускать команды или коммитить изменения. Вы застряли в копипасте кода туда-сюда.

Решение: Cookie Code внедряет слой локального выполнения в веб-чат DeepSeek:

✅ Нулевая стоимость токенов — использует ваш бесплатный веб-аккаунт DeepSeek, без API-ключей
✅ Настоящий агентный цикл — AI читает файлы → пишет код → запускает тесты → коммитит изменения
✅ Субагенты — AI делегирует задачи изолированным агентам (свой контекст, свой whitelist инструментов)
✅ Интеграция Git — смотрите diff, листайте историю, проверяйте изменения визуально
✅ Управление через Telegram — пишите код с телефона, получайте уведомления, подтверждайте команды удалённо
✅ Красивый UI — стеклянные эффекты, кастомные темы, анимированные петы, тёмная тема

---

✨ Основные возможности

🤖 AI-агент, который реально работает

Теперь AI умеет:

• 📖 Читать файлы — структура проекта, grep-паттерны, содержимое
• ✏️ Писать и редактировать код — создавать файлы, применять патчи, удалять старый код
• 💻 Запускать команды — bash, PowerShell, SQL-запросы, любые shell-скрипты
• 🔍 Искать и навигировать — находить файлы по glob, искать по regex
• 📊 Управлять задачами — создавать, отслеживать и завершать todo-списки
• 🌐 Получать данные — HTTP-запросы, API-вызовы, веб-скрапинг
• 🔧 MCP-инструменты — подключать любой MCP-сервер для расширенных возможностей
• 🧠 Двухуровневая память — AI помнит и вас, и проект: глобальная память (<userData>/memory.md) хранит факты о пользователе и системе, проектная (<projectDir>/.cuckoo/memory/ProjectMemory.md) — соглашения, архитектуру и важные пути конкретного проекта. Инструменты memorySave/memoryRead/memoryClear принимают scope ('project' | 'global' | 'all'). Файлы открываются и очищаются в настройках.

Как это работает:

1. Вы спрашиваете: "Покажи последние изменения в auth.js"
2. AI генерирует: `cuckoo const r = await grep('auth.js', 'login');`
3. Cookie Code перехватывает, выполняет, стримит результат обратно в AI
4. AI видит вывод и продолжает работать

🚀 Субагенты — AI создаёт своих помощников

Cookie Code умеет делегировать задачи изолированным AI-агентам, каждый в своём окне и со своим контекстом. Черновики, поиски и tool-вызовы субагента не засоряют основной диалог — родителю возвращается только финальное резюме.

Как это работает:

1. Вы: «Делегируй explore: найди все вызовы apiFetch»
2. AI вызывает run_agent("explore", "...", "...")
3. Открывается отдельное окно с тем же логином DeepSeek
4. Субагент работает в изоляции: glob → read → grep → ...
5. Когда закончит — окно закрывается, в чат приходит только резюме

Три способа завести агента:

• Вручную — положите cookie/agents/<имя>.md с frontmatter в проект
• Через AI — скажите «Создай агента для ревью SQL-миграций» → AI вызовет create_agent и сразу его использует
• Готовые — explore, code-reviewer, git-committer, changelog-writer уже в проекте

Что защищает:

• 🔒 Whitelist инструментов — в frontmatter агента указываете tools: read, grep → агент физически не сможет вызвать bash или mysql
• 🚫 Anti-recursion — субагент не может запустить ещё одного субагента
• ⏱ maxTurns — обрубает зацикливание (например, 40 шагов для коммиттера)
• ⏲ Timeout 10 мин — принудительно закрывает зависшее окно

Пример агента:

---
name: code-reviewer
description: Проверка качества кода. Использовать после написания кода.
tools: read, grep, glob
maxTurns: 20
---

Ты — опытный эксперт по ревью кода...

---

🎯 Цели — автономные многораундовые задачи

Команда /goal превращает задачу в самодвижущийся цикл: AI шаг за шагом продвигается к цели, пока не выполнит её — без вашего участия между шагами.

• /goal <описание> — задать цель; /goal — статус; /goal stop|pause|resume — управление
• Когда раунд ответа завершается, Cookie Code сам отправляет AI «продолжай»
• Завершение — когда AI вызывает инструмент goalDone()
• Защита от зацикливания: лимит итераций (50) и остановка при 3 раундах без прогресса
• Панель «Цель» слева: текст, итерация, таймер, кнопки Пауза/Выход
• Per-session: у каждого чата своя цель
• Задавать и управлять целью можно из Telegram (/goal), с уведомлениями о старте и завершении

🎨 Красиво и настраиваемо

• Стеклянный UI — матовое стекло с настраиваемым размытием и прозрачностью
• 27 обоев — вручную отобранные фоны встроены
• Анимированные петы — милые маскоты, реагирующие на вашу работу
• Тёмная/светлая тема — автоматическое или ручное переключение
• Кастомные шрифты — используйте свой шрифт
• RGB-эффекты — анимированное свечение никнейма

🔒 Умная защита

• Подтверждение инструментов — подтверждайте рискованные команды (bash, запись файлов) перед выполнением
• Опасные паттерны — regex-чёрный список команд, которые никогда не должны запускаться
• Скрытые служебные сообщения — чистый UI чата, но AI всё равно видит полный контекст
• Белый список на сессию — подтвердите инструмент один раз, он работает свободно до перезагрузки

📱 Интеграция с Telegram-ботом

Управляйте всем с телефона:

• /status — текущий проект, активные процессы, количество задач
• /diff — смотрите незакоммиченные изменения с подсветкой синтаксиса
• /log — листайте git-историю, показывайте diff коммитов
• /todos — управляйте списком задач удалённо
• /screen — сделайте скриншот активного окна
• /stop — убейте сбежавшие процессы

Входящие сообщения → автоматически печатаются в чат
Голосовые сообщения → распознаются через локальный Whisper и отправляются в AI
Фото/файлы → прикрепляются к полю ввода чата

📊 Интеграция Git

Встроенный просмотрщик diff:

• Вкладка "Изменения" — незакоммиченные изменения, построчные diff
• Вкладка "История" — листайте коммиты, кликайте для просмотра полного diff
• Навигация — прыгайте между hunks, фильтруйте добавленные/удалённые строки
• Мини-карта — визуальный обзор изменений
• Внутристроковый diff — посимвольная подсветка для точных правок
• Кнопка «Коммит» — склеивает unified diff всех изменённых файлов и отправляет в чат готовое сообщение с просьбой закоммитить (можно позвать агента git-committer или закоммитить самому)

⌨️ Горячие клавиши

Клавиша	Действие
F1	Показать текущий CHANGELOG (окно What's New)

📈 Дашборд статистики

Отслеживайте продуктивность:

• Тепловая карта активности — график вкладов в стиле GitHub
• Использование токенов — тренды по дням/неделям
• Любимые модели — какой AI вы используете чаще
• Отслеживание серий — самая длинная последовательность дней кодинга

---

🚀 Быстрый старт

Скачать бинарник (рекомендуется)

Windows:
Скачать CookieCode-Setup.exe → Запустить установщик → Открыть

macOS:
Скачать CookieCode.dmg → Перетащить в Applications → Открыть

Собрать из исходников

git clone https://github.com/merfiDEV/Cookie-code.git
cd Cookie-code
npm install
npm start

Требования: Node.js 16+

---

📖 Использование

Первый запуск

1. Выберите директорию проекта
2. Выберите тему (обои, стеклянные эффекты, пет)
3. (Опционально) Настройте Telegram-бота

Начните кодить

Просто общайтесь естественно:

Вы: "Покажи изменения, которые я сделал сегодня"
AI: [запускает git diff] Вы изменили 3 файла...

Вы: "Напиши тесты для функции логина"
AI: [читает auth.js, создаёт тесты, запускает их] ✅ Все 5 тестов прошли

Вы: "Закоммить это"
AI: [git commit] Закоммичено: "feat(auth): добавлены тесты логина"

Исследуйте

Откройте боковую панель для:

• 🗂️ Просмотра сессий
• 📝 Управления задачами
• 🔄 Просмотра git diff
• ⚙️ Настройки

---

🛠️ Встроенные инструменты

20+ инструментов из коробки:

Инструмент	Описание
read	Прочитать содержимое файла
write	Создать/перезаписать файл
edit	Применить патч
glob	Найти файлы по паттерну
grep	Поиск по содержимому
bash / pwsh	Запуск shell-команд
git	Git-операции
mysql	SQL-запросы
webFetch	HTTP-запросы
todoWrite	Списки задач
mcpCall	Инструменты MCP-сервера
goalDone	Завершить цель (/goal)

---

🎨 Настройка

Темы: Размытие фона, прозрачность панелей, стеклянные цвета
Петы: Бросьте PNG/GIF в userData/pets/, выберите из сетки
Шрифты: Бросьте .ttf/.woff в userData/fonts/, выберите из выпадающего списка

---

🤝 Контрибуции

1. Форкните репозиторий
2. Создайте ветку: git checkout -b feature/amazing
3. Внесите изменения
4. Тестируйте: npm test
5. Коммитьте: git commit -m 'feat: add feature'
6. Пушьте и открывайте PR

Области, где нужна помощь:

• 🌍 Переводы
• 📚 Документация
• 🐛 Отчёты об ошибках
• ✨ Новые инструменты

---

📜 Лицензия

MIT — свободно использовать, изменять, распространять. Коммерческое использование разрешено.

---

🙏 Благодарности

Собрано с Electron, DeepSeek, Telegraf

Вдохновлено Aider, Claude Desktop, Cursor

---

⭐ История звёзд

Если Cookie Code экономит ваше время, поставьте звезду!

---

Сделано с 🍪 разработчиками, для разработчиков