Хаос с кучей репозиториев

У большинства разработчиков в 2024 году локальный диск — сплошной бардак из git-репозиториев. Рабочие проекты, личные эксперименты, форки клиентов — всё валяется где попало. Сколько раз вы в полночь набирали find ~ -name "тот_самый_репо"?

С AI-агентами для кода ситуация усугубляется. Claude Code, GitHub Copilot или свои боты ускоряют работу, но требуют изоляции. Один агент рефакторит инфраструктуру, другой пишет API — им нужны отдельные пространства. Общая директория превращается в минное поле.

Переключение веток выматывает: стэшинг, конфликты, потерянные изменения. Это тормозит и людей, и AI.

Решение из трёх инструментов: ghq + gwq + fzf

Открытые инструменты уже решают проблему. Их комбинация даёт организованную среду, масштабируемую под AI-воркфлоу.

Git worktree: параллельная разработка без нервов

Сначала разберёмся с основой — git worktree. Это фича Git для нескольких рабочих директорий в одном репо. Никаких стэшей и переключений: каждый worktree на своей ветке.

Для AI-агентов это идеал. Полная изоляция:

• Агент на фиче A работает в worktree A
• Агент на баге B — в worktree B
• Нет пересечений, всё параллельно

Можно анализировать код в одном worktree, тестить в другом, а main оставлять чистым. Всё одновременно.

Инструмент 1: ghq — порядок в репозиториях

ghq (GitHub Query) наводит порядок. Клонирует репо в фиксированную структуру по URL.

Всё в ~/ghq/:

~/ghq/
  github.com/
    владелец/
      репо
  gitlab.com/
    команда/
      проект

Корень настраивается. Репо всегда на месте. Принцип: стандартизируй — и автоматизируй.

Инструмент 2: gwq — worktree на уровне профи

gwq (git Worktree Query) применяет подход ghq к worktree. Они живут рядом с оригинальными репо в том же корне.

Настройка в ~/.config/gwq/config.toml:

[naming]
template = '{{.Host}}/{{.Owner}}/{{.Repository}}={{.Branch}}'

[worktree]
basedir = '~/ghq'

Пример:

~/ghq/
  github.com/acme/api                       # базовое репо
  github.com/acme/api=платежи               # worktree для платежей
  github.com/acme/api=авторизация           # worktree для бага
  github.com/acme/frontend                  # другое репо
  github.com/acme/frontend=редизайн         # worktree для UI

Суффикс =ветка сразу показывает назначение. Удобно для параллельных задач — своих или AI.

Инструмент 3: fzf — поиск как интерфейс

fzf (fuzzy finder) связывает всё. Быстрый терминал-UI для поиска по списку.

Простая команда:

ghq list | fzf

Вместо ввода путей — fuzzy-поиск. Наберите "api" — список фильтруется. Enter — и вы в репо.

С такой структурой забываете пути. Достаточно ключевых слов.

Горячие клавиши для навигации

Инструменты позволяют создать удобные функции в шелле.

Переход в любое репо:

j() {
  cd "$(ghq list --full-path | fzf)"
}

Переключение worktree в текущем репо:

jw() {
  cd "$(git worktree list | awk '{print $1}' | fzf)"
}

Больше никаких потерь времени на поиск.

Почему это важно для AI-разработки

Сила проявляется при работе с несколькими AI-агентами. На платформе NameOcean Vibe Hosting AI ускоряет деплой фич. Предсказуемая структура файлов — не прихоть, а необходимость.

Агенты могут:

• Быстро находить код
• Точно ссылаться на файлы
• Работать параллельно без помех
• Писать надёжные скрипты

Как начать

Установка — 15 минут:

1. Установите ghq, gwq, fzf через менеджер пакетов
2. Настройте ghq: ghq.root = ~/ghq в git config
3. Создайте ~/.config/gwq/config.toml с шаблоном и basedir
4. Добавьте функции j и jw в .bashrc или .zshrc
5. Клонируйте через ghq get, а не git clone

Через часы забудете старый хаос. Через недели поймёте: это база современной разработки.

Взгляд шире

Такая связка — шаг к новой продуктивности. Не боремся с файловой системой, а подстраиваемся. Принимаем параллелизм для людей и AI.

Мелкие трения съедали 10–15% времени. Теперь их меньше. Каждый сэкономленный свитч — победа. Каждый автономный агент в worktree — умножитель скорости.

Если DX важен — освойте этот стек.