Как приручить автономного агента с помощью Scarf

Знакомая ситуация: запускаешь ИИ-агента для автоматизации рутины, а он «уходит в себя». В терминале мелькают логи, что-то скачивается, где-то создаются файлы, но прозрачности ноль. Ты сидишь и гадаешь: он сейчас реально работает над задачей или зациклился на установке зависимости, которая и так есть?

Для тех, кто использует Hermes — довольно популярного автономного агента — эта проблема решается установкой Scarf. Это нативное приложение для macOS (и теперь iOS), которое превращает консольный хаос в понятный дашборд.

Что это такое и зачем оно в моем менюбаре

Scarf — это не просто «морда» для чата. Это полноценный пульт управления агентом Hermes. Если сам Hermes — это мозг, который умеет писать код, лазить в интернет и управлять файлами, то Scarf — это его операционная система с человеческим лицом.

Разработчик проекта, awizemann, явно делал инструмент под себя. Это чувствуется в мелочах: приложение написано на Swift 6, работает быстро и не съедает ресурсы, как типичные Electron-монстры. Главная фишка здесь в том, что Scarf дает полный контроль над тем, что агент делает «под капотом».

Пять вещей, которые делают Scarf полезным

1. Прозрачность мышления

Когда вы используете современные модели вроде o1 или новые версии Grok, они генерируют так называемый «chain-of-thought» (цепочку рассуждений). В обычном чате это часто скрыто. Scarf выводит блок REASONING отдельно. Вы видите, как агент сомневается, исправляет себя и планирует шаги, прежде чем выдать итоговый код. Это бесценно для отладки промптов.

2. Управление проектами через Kanban

Это, пожалуй, самая неожиданная и крутая фича. Агент может сам создавать задачи на встроенной Kanban-доске. Вы ставите глобальную цель, а Hermes разбивает её на карточки, двигает их по колонкам и привязывает к конкретным веткам в Git. В версии 2.10 появилась возможность фильтровать доску по конкретной сессии чата — так задачи не перемешиваются, если вы ведете сразу три проекта.

3. Нативная работа с SSH

Scarf умеет подключаться к удаленным серверам. Если ваш Hermes крутится на мощном Linux-сервере в облаке или на домашнем мини-ПК, вы можете управлять им с макбука так же легко, как локальным процессом. Приложение само прокидывает туннели, делает бэкапы SQLite базы через SSH и стримит логи в реальном времени.

4. Контроль над памятью

У агентов часто возникают проблемы с «галлюцинациями» из-за замусоренной памяти. В Scarf есть встроенный редактор файлов MEMORY.md и USER.md. Если заметили, что агент запомнил какую-то ерунду или устаревший контекст, можно просто зайти в соответствующую вкладку и поправить текст руками.

5. Мониторинг расходов

Если вы используете платные API (OpenAI, Anthropic, xAI), Scarf рисует детальные графики потребления токенов. Он разделяет обычные токены и токены «рассуждения», считает стоимость каждой сессии и показывает тепловую карту активности. Помогает понять, не слишком ли дорого обходится ваша автоматизация.

Техническая изнанка

Проект интересен тем, как он взаимодействует с агентом. Scarf не лезет в логику самого Hermes, а работает как наблюдатель и контроллер:

• Читает state.db (SQLite) в режиме WAL, чтобы не блокировать запись самому агенту.
• Общается с процессом через ACP (Agent Client Protocol) — это JSON-RPC поверх стандартного ввода-вывода.
• Для терминальных функций использует SwiftTerm, что дает честную поддержку ANSI-цветов и интерактивность.

Интересно, что приложение полностью игнорирует песочницу (Sandbox) macOS. Это осознанное решение: программе нужен прямой доступ к ~/.hermes/ и возможность запускать бинарники в системе.

ScarfGo: агент в кармане

Недавно автор запустил ScarfGo — версию для iOS. Она работает через SSH. Вы генерируете ключ на айфоне, добавляете его в authorized_keys на сервере и получаете доступ к чату, памяти и дашбордам проектов прямо с телефона. Удобно, если нужно проверить статус долгой задачи, пока вы не у компа.

Стоит ли пробовать

Если вы уже используете Hermes, то Scarf — это must-have. Он снимает когнитивную нагрузку при работе с автономными агентами. Вам больше не нужно держать в голове структуру проекта или постоянно грепать логи.

Кому это не подойдет? Тем, кто ждет «магическую кнопку». Scarf — это профессиональный инструмент. Чтобы он приносил пользу, нужно понимать, как работает Hermes, настроить MCP-серверы (Model Context Protocol) и уметь конфигурировать провайдеров моделей.

Проект активно развивается: обновления выходят почти каждую неделю, синхронно с новыми релизами Hermes. Если вы цените качественный нативный софт и экспериментируете с ИИ-агентами, загляните в репозиторий.

Как начать:

1. Убедитесь, что у вас установлен Hermes.
2. Скачайте бинарник Scarf из раздела Releases на GitHub.
3. Если при запуске macOS ругнется на «поврежденный файл» (обычная история для софта не из App Store), выполните в терминале: xattr -d com.apple.quarantine /Applications/Scarf.app

Проект распространяется под лицензией MIT, так что можно смело копаться в исходниках на Swift и адаптировать под свои нужды.