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

#Перед началом

• Агент для написания кода, который работает в терминале, установлен и в котором выполнен вход: например, Claude Code (claude), Codex (codex) или Gemini CLI (gemini). Ferret запускает его во встроенном терминале. Подойдёт любой агент из списка поддерживаемых, а также любой другой CLI, который вы добавите сами.
• Веб-приложение, которое открывается по URL, например dev-сервер на http://localhost:3000.
• Микрофон. Фидбэк — это ваш голос плюс перо. Без микрофона обведённые пером места всё равно становятся замечаниями, но без слов.

#1. Установка

Скачайте сборку для своей ОС на странице загрузки и откройте её. Сборка для macOS подписана Developer ID и нотаризована Apple, поэтому открывается как любое другое приложение. Сборки для Windows и Linux пока не подписаны, поэтому при первом запуске нужен один дополнительный шаг. Про Windows SmartScreen, Linux и сборку из исходного кода см. Установка.

#2. Откройте проект и URL

1. Выберите Файл → Открыть папку проекта… (⌘O / CtrlO) и укажите корень репозитория.
2. Введите URL dev-сервера в адресную строку браузера (⌘L / CtrlL) и нажмите Enter.
3. По желанию нажмите + (Сохранить текущий URL), чтобы сохранить его как пресет, открываемый одним щелчком, например local, dev или prd.

При открытии проекта в этой папке также запускаются ваши агенты во вкладках терминала. По умолчанию это Claude Code и Codex; выберите нужные в Настройки → Агенты → Запуск при открытии проекта (см. Настройки).

#3. Запись

1. Нажмите Запись в заголовке окна или ⌘⇧R / CtrlShiftR. Окно переключится в режим фидбэка.
2. Пользуйтесь страницей как обычно и говорите, что нужно изменить.
3. Удерживая ⌥ / Alt (или выбрав Перо), обведите мышью место, о котором говорите.
4. Нажмите Стоп или ещё раз ⌘⇧R / CtrlShiftR.

Каждый момент, когда вы говорите или обводите, становится одним замечанием: скриншот с пометками пером, запрос, исходные слова, URL и элемент, на который вы указали.

#4. Проверьте замечания

После остановки окно возвращается в режим редактора и открывает вкладку Замечания.

• Заголовок или запрос можно править прямо на месте.
• Для каждого замечания можно переключать Отправить / Не отправлять, выбрать Объединить со следующим или Удалить.
• Отменить откатывает последнюю правку.

#5. Отправьте агенту

1. Нажмите Отправить агенту. Замечания уйдут агенту в текущей вкладке терминала или запущенному агенту. Стрелка рядом с кнопкой позволяет выбрать конкретного агента или вкладку.
2. Если ни один агент ещё не запущен, Ferret сначала запустит его и отправит, как только он будет готов.

Ferret вводит одну инструкцию в поле ввода агента и отправляет её. По умолчанию она начинается так:

Прочитай "{{path}}" и изображения замечаний в той же папке, затем реализуй каждое замечание, отмеченное для отправки. …

Дальше агента просят проверить каждое изменение на реальном экране, записывать прогресс по каждому замечанию и в конце выдать список «Готово / Не готово». Агент читает .ferret/reviews/<timestamp>/feedback.md и PNG-файлы рядом с ним. Видео никогда не отправляется. Используете агента вне Ferret? Нажмите Копировать для агента и вставьте текст.

Инструкция по умолчанию зависит от языка интерфейса. Её можно заменить в настройках: см. Настройка инструкции.

#Что дальше

• Основные понятия: режимы, замечания и то, что получает агент
• Распознавание речи и расходы: скачайте бесплатную модель whisper для работы на устройстве или подключите свой эндпоинт
• Сочетания клавиш