Перейти к содержимому

Агенты

ffgit работает с агентами для программирования, которые у вас уже есть: он запускает установленные CLI Claude Code и Codex с вашим собственным аккаунтом. ffgit не предоставляет модель и не перепродаёт токены. Сами разговоры описаны на странице Chat.

Запуск задачи для агента

Section titled “Запуск задачи для агента”
  1. Выберите Agents → Start agent task… или Start agent task… в меню ветки. В Chat откроется новый чат в виде черновика.

  2. Напишите задачу, выберите агента, логин, модель и effort, а также место работы — этот worktree или новый. Templates заполняют задачу одним из двенадцати готовых промптов — например, ревью, после которого git status остаётся прежним, — или вашим собственным.

  3. Запустите задачу. ⌘↩︎ запускает её и сохраняет черновик, чтобы ту же задачу можно было отдать другому агенту или модели — каждому в новом worktree со следующим свободным именем.

Новый worktree получает свободную ветку, названную по агенту и задаче, в папке рядом с основной рабочей копией. Из меню ветки чат работает в worktree, где эта ветка извлечена, или в новом worktree, ветка которого начинается с неё; Stack on делает эту новую ветку стековой.

Если установлено несколько копий Claude Code или Codex, ffgit запускает самую новую из работающих. Когда она отстаёт от последнего релиза, New chat сообщает об этом, а Update запускает собственное обновление агента в Terminal.

Новый worktree для агента может сначала выполнить настройку worktree (worktree setup) проекта: скопировать игнорируемые файлы из основной рабочей копии, выполнить команды и проверить пути. Настройка запускается только после того, как вы просмотрели каждый шаг, идёт в фоне с кнопкой Cancel, а агент стартует, когда она завершится.

  • Храните настройку On this Mac (на этом Mac) или In the repository (в репозитории) — как .ffgit/worktree-setup, чтобы закоммитить её и поделиться.
  • Редактор начинает с того, что в проекте уже есть для других инструментов, — локального окружения Codex, worktrees.json от Cursor, скрипта настройки Conductor, .worktreeinclude от Claude Code — или с догадки по lock-файлам и игнорируемым файлам .env.
  • Шаги находят основную рабочую копию и worktree в $FFGIT_SOURCE_PATH и $FFGIT_WORKTREE_PATH.

Действия проекта и dev-серверы

Section titled “Действия проекта и dev-серверы”

Project actions… в меню worktree хранит именованные команды, например Run tests, и settle-скрипт, который выполняется, когда вы завершаете чат через Settle. В Chat меню чата запускает их в его worktree — каждую во вкладке выдвижной панели под разговором.

Действие, имя которого заканчивается на [server], — это dev-сервер: он получает свободный порт в $PORT и $FFGIT_PORT, каждый раз один и тот же, пока он свободен, так что серверы двух worktree никогда не конфликтуют. Когда сервер начинает слушать порт, его вкладка показывает адрес http://localhost:<port> с кнопками Open, Copy и Restart.

Статус в реальном времени

Section titled “Статус в реальном времени”

Для Claude Code ffgit читает файл статуса, который Claude Code ведёт для каждой запущенной сессии (~/.claude/sessions/<pid>.json): работает, ждёт разрешения или ввода, простаивает или ответ готов после очередного хода. Запуск из ffgit также сообщает, чего именно он ждёт, — Needs permission, Asking a question, Waiting for you, Rate limited, Error и другое. Эти данные приходят из хуков, действующих только в этой сессии; в ваши файлы настроек они никогда не записываются. Чаты, которые запускает ffgit, сообщают свой статус в собственном потоке.

У Agents две вкладки:

  • Sessions — запуски ffgit, живые сессии Claude Code и найденные сессии Codex и Claude Code в одном списке или на доске: Needs you, Working, Ready, Errors, Idle. Фильтруйте по проекту, агенту и статусу и сужайте область до worktree, проекта, рабочего пространства или всех проектов. Двойной щелчок открывает чат в Chat.
  • Activity — единый инбокс для вопросов, готовых ответов и ошибок с видами Needs you, Ready for review, Errors и All activity. Панель разделов и колокольчик показывают число непрочитанных тредов рабочего пространства этого окна.

Jump to… (Cmd/Ctrl+K) находит чаты, проекты, worktree, ветки и действия меню по словам в любом порядке, а с вашего разрешения — и чаты по их сообщениям (см. Поиск чатов). Waiting for you (Cmd/Ctrl+Shift+I) показывает только чаты, которые ждут вашего ответа, — сначала те, что ждут дольше всех.

Боковая панель показывает агентов прямо в дереве проектов: счётчики статусов у каждого проекта, значок у каждого worktree и до трёх строк агентов под ним. Worktree группируются по состоянию: сначала активные, затем Done (все коммиты уже в ветке по умолчанию) и Unavailable.

С настройкой Notify me when a chat needs me (по умолчанию выключена) чат, который ждёт или завершается, пока ffgit в фоне, вызывает уведомление macOS, а Dock показывает число ожидающих чатов. Вы выбираете виды уведомлений (Needs you, Finished, Failed, Setup), звук и то, называет ли уведомление задачу. Пока ffgit активен, окно показывает то же самое всплывающим сообщением.

Сравнение с началом задачи

Section titled “Сравнение с началом задачи”

Агент, которого ffgit запускает в Terminal, сначала получает базу задачи (task baseline): worktree в том виде, в каком он был в этот момент, сохранённый только как объекты Git — без коммита, ссылки, stash или изменения индекса. Compare with task start… показывает Since task started, Current uncommitted changes и Commits since launch base — с формулировками о наблюдаемых изменениях, а не об изменениях агента.

Подробности сессии показывают всё, что её чат хранит на этом Mac, — разговор, scratchpad и вывод задач, изображения и планы, а также worktree, который для него создал инструмент агента, — с разделением на то, что можно освободить (следующий запуск запишет это снова), что освобождать с осторожностью и что сохраняется.

  • Список Agents показывает размер каждого чата с итогами по проектам, а также учтённые в нём worktree агентов.
  • Clean up chats… показывает чаты старше выбранного вами возраста и удаляет их или освобождает их место — по одному, пропуская те, что работают или чьи файлы удерживает какой-то процесс.
  • Free build output… перемещает результаты сборки и пакеты из worktree агентов в Корзину; .env, другие игнорируемые файлы и сами worktree остаются.
  • Remove agent worktrees by themselves в Cleanup удаляет простаивающие worktree агентов по выбранному вами правилу, предварительно создав резервную копию.