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

История и ветки

History строит топологический граф коммитов по веткам, тегам и удалённым репозиториям — с фильтрацией веток, рёбрами слияний и постраничной загрузкой. Каждый коммит — одна строка, как рисует Fork: линии держат свою колонку, ветка по умолчанию занимает первую, а заголовок слияния приглушён.

  • Метки отличают локальные ветки, remote-tracking-ветки, теги, ветки, извлечённые в другом worktree, и detached HEAD других worktree. При наведении на метку её история подсвечивается, а остальное приглушается.
  • Метки веток и HEAD показывают main ↑2 ↓1 — неотправленные и неполученные коммиты. Счётчики берутся из локальных ссылок, ничего не загружается.
  • Строка над графом называет незакоммиченные изменения или незавершённый merge, rebase, cherry-pick или revert.
  • Ветки, которые уже содержатся в ветке по умолчанию, приглушены и стоят в конце; меню вида показывает или скрывает их. Шеврон слияния сворачивает коммиты, которые приносит только его ветка.
  • Current and main показывает HEAD, его upstream и ветку по умолчанию; меню вида также может скрыть remote-tracking-ветки или оставить только первых родителей.
  • Искать в истории можно по сообщению, автору, хешу, пути или добавленному либо удалённому тексту.
  • Details в заголовке коммита показывает всё сообщение, автора и коммиттера, соавторов, а также ветки и теги, которые содержат этот коммит.

Стрелки, Page Up/Down и Home/End перемещают выделение; Alt+Up/Down переходит к дочернему коммиту или к первому родителю, Enter открывает файл, а Cmd/Ctrl+C копирует хеш.

Щелчок по ветке показывает её историю; переключение — отдельное действие с подтверждением. Двойной щелчок по строке предлагает переключиться на локальную ветку в ней, которую не занял другой worktree, а если такой нет — на сам коммит. В меню коммита, как в Fork, есть подменю для каждой ветки на этом коммите и подменю Compare и Copy. Из него можно сравнивать, создавать ветки и теги, делать merge, rebase, cherry-pick и revert и открывать коммит на GitHub или GitLab.

Merge или rebase сначала показывает, что произойдёт: сколько коммитов на каждой стороне и пять самых новых из тех, что будут принесены или переиграны, nothing to merge, fast-forward или коммит слияния, а также скольким уже отправленным коммитам rebase даст новые ID.

Правка локальной истории

Section titled “Правка локальной истории”

Edit history from here… в меню коммита позволяет изменить сообщения, порядок (перетаскиванием или кнопками перемещения), объединить (squash, fixup) и разделить (по файлам) коммиты текущей ветки, которых нет ни в одной другой ветке, теге, remote или worktree.

  • Ревью показывает точное «до» и «после», а изменённые сообщения — в том виде, в каком их оставит хук commit-msg репозитория.
  • Ничего не меняется до Rewrite, и ветка сдвигается, только если её вершина осталась той, что видело ревью.
  • Резервная копия сохраняет старые коммиты; в Backups из них можно снова создать ветку.
  • Отправленные коммиты, слияния и общие коммиты не принимаются — с объяснением причины.

Fetch, pull, push и clone показывают в шапке, что делает Git и насколько он продвинулся (Pulling from origin/main · Receiving objects 45%).

  • Pull — только fast-forward. При локальных изменениях он предлагает отмену, просмотр изменений, только fetch или Save and pull, который на это время сохраняет их в stash.
  • Когда ветка и её upstream разошлись, Pull об этом сообщает (main and origin/main have diverged: 1 commit here, 2 on origin/main) и предлагает Rebase onto origin/main или Merge origin/main — после резервной копии.
  • Сохранённые изменения, которые конфликтовали бы с обновлённой веткой, сначала просчитываются без изменения файлов; панель называет их, а Restore and resolve… записывает их конфликты, чтобы вы их разрешили.
  • Профиль GitHub или GitLab может содержать SSH-ключ или сохранённый токен, который используется только для этого процесса Git.

У незавершённых merge, rebase, cherry-pick или revert над окном появляется панель: Resolve conflicts, пока остаётся хотя бы один конфликт, и Abort…, Skip commit… и Continue…, когда конфликтов не осталось, — каждое действие с подтверждением и после резервной копии. Остановка на конфликтах не показывается как ошибка; если операцию запустили из этого окна, первый конфликт открывается в Changes.

  • В Changes файл показывается с номерами строк и подсветкой синтаксиса, а каждый конфликт — это карточка, которая принимает Current, Incoming, обе стороны, базу или текст, который вы напишете. Три колонки (Current · Result · Incoming) или весь результат текстом — в один щелчок.
  • ⌥↑ и ⌥↓ переходят между конфликтами. Mark resolved записывает результат, только когда конфликтов не осталось.
  • Open in отправляет файл в установленный или настроенный в Git инструмент слияния, а его результат возвращается на ревью. Merge tools… выбирает инструмент для одного репозитория или для всех.
  • Resolve with agent… на панели помещает задачу по оставшимся конфликтам в поле сообщения чата — только в этом worktree. Вы читаете, правите и отправляете её, а потом сами проверяете результат и продолжаете операцию.
  • Файл, маркеры конфликтов в котором удалены вне ffgit — агентом или редактором, — сравнивается с конфликтом, который записал Git, так что вы проверяете каждый разрешённый в нём конфликт. Файлы, которые проиндексировал агент, остаются в Resolved, пока операция не завершится.

Needs you в Activity перечисляет каждый worktree, остановленный на конфликтах, с действиями Show conflicts и Resolve with agent….

  • Переключайте и создавайте ветки; перед переключением ffgit запрашивает подтверждение. Меню ветки переименовывает и удаляет локальные ветки, задаёт или убирает их upstream.
  • Боковая панель показывает ваши ветки отдельно от веток агентов (claude/, codex/ и добавленные вами префиксы), а ветки агентов делит по тому, есть ли они уже в ветке по умолчанию.
  • Находите, создавайте и открывайте связанные worktree. Новый worktree извлекает свои сабмодули (All — по умолчанию, Top level или None).
  • Строки боковой панели показывают, что есть только в этом worktree (2 not pushed, 1 not on any branch), или что его работа уже в ветке по умолчанию (In main). Когда два worktree меняют один и тот же файл, каждый называет другой — это раннее предупреждение о конфликте слияния.
  • Start agent task… в меню ветки открывает New chat об этой ветке — в worktree, где она извлечена, или в новом, который начинается с неё. См. Агенты.
  • Keep the default branch current предлагается один раз в проекте, где у ветки по умолчанию есть upstream, и выключена, пока вы её не включите. Тогда ffgit каждые 15 минут делает fetch и перематывает ветку по умолчанию вперёд, чтобы новые worktree начинались со свежего кода, — только пока она извлечена, без изменений и без собственных коммитов, и никогда не сливает.

Stack on… в меню ветки задаёт ветку, поверх которой она строится, а Unstack убирает эту связь. Тогда боковая панель показывает стековую ветку под её родителем вместе с состоянием: on a, a has 3 new commits, a was rewritten, a is in main или a is gone.

  • Bring b up to a… сливает родителя в отставшую стековую ветку — с обычным ревью слияния.
  • Restack b onto a… переигрывает собственные коммиты ветки и всех веток, стоящих на ней, если этих коммитов нет ни в remote, ни в теге, ни в другой ветке. Сначала всё просчитывается в памяти и проходит ревью, а затем выполняется после резервной копии, которая закрепляет все старые вершины. Ничего не отправляется (push). Для restack нужен Git 2.40 или новее.
  • Create pull / merge request… из стековой ветки делает её родителя базой запроса, а Review предлагает Change base to main…, когда запрос родителя слит.

Open in в шапке (а также в меню проекта и worktree на боковой панели) открывает worktree в Terminal, iTerm, Warp или Ghostty, в Finder или в установленном редакторе — например, VS Code, Cursor, Antigravity, Windsurf, Zed, Sublime Text или IDE JetBrains. View on GitHub или View on GitLab открывает страницу upstream-ветки.

Видимые репозитории обновляются после операций Git, по событиям файловой системы и по опросу статуса раз в две секунды; окна в фоне приостанавливают наблюдение за файлами.