Проблема текстовых описаний в AI-кодинге
Современные AI-агенты, такие как Claude Code, Cursor и Windsurf, часто описывают архитектуру или модели данных текстом. Это создает когнитивную нагрузку. Snip решает эту проблему, внедряя «визуальный режим». Когда агент генерирует Mermaid-диаграмму или HTML-превью компонента, Snip автоматически рендерит их в нативном окне для обзора, а не просто выводит код в терминал.
Как работает цикл обратной связи
Процесс построен на прямом взаимодействии через CLI и системный трей. Агент вызывает команду рендеринга, пользователь видит визуализацию, вносит правки (обводит ошибки, добавляет стрелки, пишет заметки) и отправляет результат обратно. Агент получает структурированный JSON с решением:
| Поле JSON | Значение | Описание |
|---|---|---|
| status | "approved" | "changes_requested" | Статус одобрения изменения |
| edited | boolean | Были ли внесены визуальные правки |
| path | string | Путь к файлу или скриншоту |
| text | string | Текстовая аннотация пользователя |
Локальный AI и стек технологий
Ключевое преимущество Snip — полная приватность и отсутствие облачных зависимостей для базовых функций. Вся работа с изображениями и категоризацией скриншотов происходит локально. Для семантического поиска и организации снимков используется локальная LLM через Ollama, а для сегментации объектов — модель SlimSAM (ONNX).
Технический стек проекта:
- Фреймворк: Electron 33
- Графика: Fabric.js 7, Mermaid.js 11
- AI: Ollama (локальные модели), HuggingFace Transformers.js
- Платформы: macOS 14+ (Apple Silicon), Linux (Wayland)
Интеграция и установка
Для разработчиков, использующих Claude Code, достаточно выполнить одну команду: snip setup. Это автоматически настраивает правила, навыки (/diagram) и разрешения. Для агентов без доступа к оболочке (например, Claude Desktop) предусмотрен MCP Server, экспонирующий те же функции через API.
Установка доступна через Homebrew для macOS или как AppImage/DEB для Linux:
brew install --cask rixinhahaha/snip/snip
Дополнительные возможности
Помимо интеграции с AI, Snip является полноценным инструментом для скриншотов. Поддерживаются быстрые снимки (Cmd+Shift+1), выделение областей, аннотации (стрелки, текст, размытие) и автоматическая категоризация сохраненных изображений с помощью AI. Проект распространяется под лицензией MIT и является бесплатным.
Источник: Github ↗
