Урок 19 · Paradev: параллельные агенты в worktrees · SI Academy

УРОК 19 · МОДУЛЬ VI

Paradev: параллельные агенты в worktrees

19.1Paradev за 60 секунд

WORKTREE · WIP ≤ 2 · ВАШИ ПОДПИСКИ

ВЕРДИКТ

Paradev — бесплатная open-source оболочка, где каждый клиент получает свою копию проекта (git worktree) и своего агента. Два клиента в работе параллельно, файлы не пересекаются, токенов сверх вашей подписки Claude не тратится.

СКАЧАТЬ PARADEV ↗paradev.com ↗

Проект	Один git-репозиторий. Подпапка репозитория отдельным проектом не становится — Paradev сводит её к корню.
Рабочая область	Отдельная ветка + отдельная папка-копия (worktree). Агент правит только её.
WIP ≤ 2	Не больше двух активных областей: третья задача ждёт. Это закон фокуса, а не ограничение программы.
Хуки	Paradev сам прописывает хуки в Claude Code и видит каждую сессию: старт, вопрос, ошибку, финиш.

Главное окно Paradev со списком проектов и строкой ввода задачи — Главный экран: проекты слева, внизу — устройство, проект, режим Worktree и ветка.

19.2Установка за 3 минуты

GITHUB RELEASE · ПРОВЕРКА ПОДПИСИ · /APPLICATIONS

Скачиваем последний релиз под Apple Silicon, проверяем нотаризацию Apple и только потом ставим. Приложение называется Superset.app — так Paradev распространяется в релизах.

terminal · установка Paradev

URL=$(curl -s https://api.github.com/repos/ParadevAI/Paradev/releases/latest \
  | python3 -c "import json,sys;print([a['browser_download_url'] for a in json.load(sys.stdin)['assets'] if a['name'].endswith('arm64.dmg')][0])")
curl -L -o /tmp/Paradev.dmg "$URL"
MNT=$(hdiutil attach -nobrowse -readonly /tmp/Paradev.dmg | awk -F'\t' '/\/Volumes\//{print $NF}')
spctl -a -vv "$MNT/Superset.app"        # должно быть: accepted · Notarized Developer ID
ditto "$MNT/Superset.app" /Applications/Superset.app
hdiutil detach "$MNT" -quiet && open /Applications/Superset.app

Не снимайте карантин (xattr -cr) с приложения, которое не прошло spctl: это единственная проверка, что файл подписан разработчиком и не подменён.

При первом запуске нажмите Continue with GitHub — авторизацию формирует само приложение. Сторонние OAuth-ссылки из чатов не открывайте.

19.3Первый проект

ПРОЕКТЫ → ОТКРЫТЬ ПРОЕКТ

Шаг 1 · Открыть папку

На экране «Добавьте первый проект» нажмите Открыть папку. Позже — иконка папки справа от заголовка ПРОЕКТЫ → Открыть проект. ⌘O здесь не работает.

Шаг 2 · Выберите корень репозитория

Папку, где лежит .git. Если папка не под git — сначала git init и первый коммит.

Список проектов Paradev — Переключатель проектов внизу окна: «Без проекта», ваши репозитории и действия «Открыть из папки», «Клонировать по URL».

19.4Рабочая область на каждого клиента

ВЕТКА CLIENT/<ИМЯ> · РЕЖИМ WORKTREE

Новая рабочая область→ветка client/имя→setup-скрипт→@имя задача→превью→merge в main→деплой

Внизу окна режим Worktree (собственная ветка и копия файлов). Локальная — работа прямо в основной папке, только для мелочей.
Новая рабочая область → ветка client/kate-yoga (имя папки клиента).
Первое сообщение агенту начинайте с триггера: @kate поправь мобильную вёрстку карточек.
Закончили — review диффа, merge в main, область удаляете. Ветка остаётся в истории.

Выпадающий список веток Paradev с worktree — Список веток: main и две рабочие области (feature/client-sprint, feature/jiva-yoga) с пометкой worktree.

Полный доступ в строке ввода — агент выполняет команды без подтверждений внутри своей области. Нужен контроль — переключите режим, и запросы прилетят в чёлку через Coucou (урок 20).

19.5Setup и Run: приватный контекст и превью одной кнопкой

~/.paradev/projects/<путь>/config.json

Новая рабочая область — это чистая копия из git. Всё, что в .gitignore (ключи, приватные заметки клиента, локальная память агента), туда не попадает. Setup-скрипт подкладывает это ссылками, Run поднимает превью на свободном порту. Конфиг лежит у вас в домашней папке, репозиторий не меняется.

~/.paradev/projects/Users/you/project/config.json

{
  "setup": ["~/.paradev/projects/Users/you/project/setup.sh"],
  "teardown": [],
  "run": ["~/.paradev/projects/Users/you/project/run.sh"]
}

КИТ МОДУЛЯ VI · .ZIP ↓setup.sh · КИТ .ZIP ↓run.sh · КИТ .ZIP ↓

terminal · распакуйте кит и запустите из корня вашего проекта

unzip -o ~/Downloads/si-academy-module-6-kit.zip -d ~/si-kit
bash ~/si-kit/paradev-install-scripts.sh

SETUPСсылки, не копии

Приватные папки, локальные .md-карты и память Claude видны в каждой области и не попадают в коммиты.

RUNПревью на свободном порту

Кнопка Run → python http.server → вкладка браузера открывается сама.

ПРИОРИТЕТПользовательский конфиг

~/.paradev/projects/… сильнее файла в репозитории: команда не видит ваши пути.

19.6Чек-лист: Paradev готов

ОТМЕЧАЙТЕ — ПРОГРЕСС СОХРАНЯЕТСЯ

spctl показал accepted · Notarized Developer ID
Вход через GitHub выполнен в самом приложении
Проект открыт из корня git-репозитория
Создана рабочая область с веткой client/…
Setup-скрипт отработал: приватные папки видны в области
Кнопка Run открыла превью
Активных областей не больше двух