Хаосът с множеството репозитория

Ако си разработчик през 2024 г., компютърът ти сигурно е пълен с git клонове. Работа, лични проекти, експерименти, клиентски код – всичко разхвърляно по папките. Колко пъти си търсил с find някой забравен репозиторий посред нощ?

Сега добави AI кодиращи агенти като Claude или GitHub Copilot. Те ускоряват работата, но създават проблем: изолация. Когато един агент рефактори инфраструктура, а друг пише API – имат нужда от отделни пространства. Споделена папка вече пречи.

Превключването между branch-ове става мъка. Stash-ове, конфликти, изгубени промени – това забавя и хората, и AI.

Решението с три инструмента: ghq + gwq + fzf

Има добра новина. Open-source общността вече е решила проблема. Комбинирай три инструмента и ще имаш организирана среда, готова за AI.

Git worktree: паралелна работа без проблеми

Основа е git worktree. Той позволява няколко работни директории за един репозиторий. Вместо да смениш branch, създаваш отделен worktree за всеки.

За AI агенти това е идеално – изолация:

• Агент за feature A работи в worktree A
• Агент за bug B – в worktree B
• Няма сблъсъци
• Всичко върви паралелно

Можеш да анализираш код в един worktree, да тестваш в друг, докато main остава чист.

Инструмент 1: ghq – ред в репозиториите

ghq (GitHub Query) организира клоновете в стандартна структура по URL.

Вместо хаос, всичко отива в:

~/ghq/
  github.com/
    owner/
      repo-name/
  gitlab.com/
    team/
      project/

Контролираш root-а (обикновено ~/ghq). Сега всеки repo е на предсказуемо място. Стандартизирай – и автоматизирай.

Инструмент 2: gwq – worktree-та като профи

gwq (git Worktree Query) прилага същото за worktree-та. Те се създават до основните репозитории.

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

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

[worktree]
basedir = '~/ghq'

Резултатът:

~/ghq/
  github.com/acme-corp/api                    # основен repo
  github.com/acme-corp/api=feature-payments   # worktree за плащания
  github.com/acme-corp/api=bugfix-auth        # worktree за auth
  github.com/acme-corp/frontend               # друг repo
  github.com/acme-corp/frontend=redesign-ui   # worktree за UI

Суфиксът =branch показва веднага за какво става дума. Перфектно за множество задачи – човешки или AI.

Инструмент 3: fzf – търсене като магия

fzf (fuzzy finder) свързва всичко. Бърз терминал интерфейс за търсене.

Просто:

ghq list | fzf

Филтрирай с "api" и директно cd в repo-то. Съчетай с структурата – и забрави сложните пътища. Пиши ключови думи, fzf свършва останалото.

Бързи команди за навигация

С тези инструменти създай функции в shell-а.

За скок в repo (основен или worktree):

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

За worktree в текущия repo:

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

Добави в .bashrc или .zshrc – и смени контекста за секунди.

Защо е ключово за AI разработка

Цената излиза с множество AI агенти. На NameOcean's Vibe Hosting ползват AI за бързи функции. Предсказуема структура помага:

• Агентите намират код бързо
• Сигурни пътища до файлове
• Чисто разделяне на задачи
• Автоматизация без грешки

Как да започнеш

Инсталацията отнема 15 минути:

1. Инсталирай: ghq, gwq, fzf от package manager
2. Настрой ghq: ghq.root = ~/ghq в git config
3. Настрой gwq: Създай ~/.config/gwq/config.toml с template и basedir
4. Добави функции: В shell config-а
5. Клонирай: Използвай ghq get вместо git clone

След часове ще се чудиш как си живял без това. След седмици – основа за всяка работа.

По-широката картина

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

Забавянето от 10-15% време изчезва постепенно. Всеки спестен скок е победа. Всеки самостоятелен AI в worktree умножава резултата.

Ако искаш топ developer опит – овладей този набор.