RepoPilot Bridge

🔒 Кросс-платформенный локальный мост для AI coding agents. Вы запускаете RepoPilot на своём компьютере, выбираете локальный проект — а ИИ-агент получает HTTP/OpenAPI-доступ только к этому репозиторию: чтение, изменения, dev-команды, diff, cleanup и безопасный commit. git push всегда заблокирован.

RepoPilot Bridge работает на Windows, macOS и Linux. Интерфейс, подсказки и документация — на русском; технические имена endpoint-ов — на английском для предсказуемой OpenAPI-интеграции.

---

Установка

Одна команда — RepoPilot скачается, установит зависимости и запустится.

Платформа	Установка	Чистая переустановка
🪟 Windows	powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/Yahor777/repopilot-bridge/v3.10.1/bootstrap.ps1 | iex"	powershell -NoProfile -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/Yahor777/repopilot-bridge/v3.10.1/bootstrap-clean.ps1 | iex"
🍎 macOS	curl -fsSL https://raw.githubusercontent.com/Yahor777/repopilot-bridge/v3.10.1/bootstrap.sh | bash	bash ~/.local/share/RepoPilotBridge/app/uninstall.sh && curl -fsSL https://raw.githubusercontent.com/Yahor777/repopilot-bridge/v3.10.1/bootstrap.sh | bash
🐧 Linux	curl -fsSL https://raw.githubusercontent.com/Yahor777/repopilot-bridge/v3.10.1/bootstrap.sh | bash	bash ~/.local/share/RepoPilotBridge/app/uninstall.sh && curl -fsSL https://raw.githubusercontent.com/Yahor777/repopilot-bridge/v3.10.1/bootstrap.sh | bash

📥 Установка локально из папки (для разработки)

Windows:

powershell -ExecutionPolicy Bypass -File .\install.ps1 -Start

macOS / Linux:

bash ./install.sh --start

⚙️ Требования

Windows: Windows 10+, PowerShell 5+, Git, Python 3.10+, cloudflared (установятся автоматически через winget).

macOS: macOS 11+, Homebrew, Git, Python 3.10+, cloudflared. Установка одной командой:

brew install git python@3.12 cloudflared

Linux: любой современный дистрибутив, git, python3, curl. Установка:

sudo apt install git python3 python3-venv curl   # Debian/Ubuntu
sudo dnf install git python3 curl                 # Fedora

Tailscale (опционально, для Tailscale Funnel вместо Cloudflare Tunnel):

brew install --cask tailscale        # macOS
sudo apt install tailscale           # Linux

После установки запускайте просто:

repopilot

Если терминал не видит команду repopilot — откройте новую вкладку или запустите напрямую:

# macOS / Linux
bash ~/.local/share/RepoPilotBridge/app/start.sh

# Windows
powershell -ExecutionPolicy Bypass -File "$env:LOCALAPPDATA\RepoPilotBridge\bin\repopilot.ps1"

Подробная короткая инструкция: QUICKSTART.md.

---

Возможности

• 🖥️ Кросс-платформенный — Windows, macOS и Linux в одном репозитории.
• 🔌 Подключение локального Git-репозитория к AI coding agent через HTTP/OpenAPI.
• 🌐 Временный туннель — Cloudflare Tunnel (по умолчанию) или Tailscale Funnel (*.ts.net).
• 🔑 Защита каждого endpoint-а через X-API-Key.
• 🛡️ Три режима — Безопасный просмотр, Автопилот, Полный режим.
• 🚫 Блокировки — .env, приватные ключи, git push, изменение remotes, опасные системные команды (sudo, dd, mkfs, diskutil, launchctl и др.).
• ✅ Безопасный commit только через /git/commit с проверкой секретов и staged-файлов.
• 📋 Audit logs и task reports для каждой сессии.
• 🩺 Doctor-проверка установки во всех режимах.
• 🧠 Запоминание ранее добавленных репозиториев.
• ⚡ Глобальная команда repopilot после установки.

Режимы

Безопасный просмотр

Только чтение. Агент может изучать структуру проекта и файлы, но не может писать файлы или запускать команды.

Автопилот

Рекомендуемый режим для обычной разработки. RepoPilot создаёт ветку promptql/*, агент может менять файлы, запускать dev-команды и делать commit через /git/commit.

git push всегда заблокирован.

Полный режим

Расширенный режим внутри выбранного репозитория. Он полезен для сложных задач, но требует понимания рисков: build/test-скрипты проекта всё равно могут выполнять произвольный код.

Как подключить AI-инструмент

После запуска RepoPilot открывает менеджер сессий. В нём можно создать новую сессию (N), открыть существующую сессию номером, копировать данные подключения (C, T, K, P, A), смотреть логи (L), останавливать выбранную сессию (S) и удалять остановленные истории (U в менеджере или D в карточке stopped-сессии).

Для каждой сессии RepoPilot показывает:

• URL туннеля;
• X-API-Key;
• prompt подключения;
• шаблон задачи.

Сервер RepoPilot и выбранный tunnel provider запускаются скрыто в фоне. Если выйти из менеджера через Q, сессии продолжат работать; повторный запуск repopilot снова откроет менеджер.

По умолчанию используется Cloudflare Tunnel. В менеджере можно открыть G = настройки и переключить дефолт на Tailscale Funnel.

Tailscale-режим использует именно Tailscale Funnel, то есть публичный HTTPS URL вида *.ts.net. Для него нужен установленный Tailscale, вход в аккаунт, MagicDNS/HTTPS и разрешённый Funnel в tailnet policy.

Если Tailscale не найден, RepoPilot предложит установить его прямо из настроек через winget. После установки в настройках можно нажать L, чтобы выполнить tailscale up, открыть логин и подключить устройство без ручного поиска Tailscale. Если tailnet ещё не разрешает Funnel, RepoPilot сам покажет ссылку login.tailscale.com/f/funnel, скопирует её в буфер и попробует открыть браузер; после подтверждения нужно запустить сессию ещё раз.

Название, которое вы вводите в RepoPilot при старте, - это только название сессии для истории и возврата к запуску. Настоящее ТЗ пишите отдельным сообщением в PromptQL или вставляйте в шаблон задачи перед отправкой AI.

В PromptQL или другом OpenAPI-клиенте используйте:

• base_url: URL туннеля;
• api_docs_url: <URL туннеля>/openapi.json;
• auth header: X-API-Key;
• значение ключа вставляйте только в защищённое поле интеграции, не обычным сообщением в чат.

Проверка установки

Windows

powershell -ExecutionPolicy Bypass -File .\doctor.ps1

Для автоматического запуска без ожидания Enter:

powershell -ExecutionPolicy Bypass -File .\doctor.ps1 -NoPause

macOS / Linux

bash ./doctor.sh

Doctor прогоняет сервер во всех режимах (read_only / autopilot / full) на временном git-репозитории и проверяет эндпоинты, блокировки опасных команд, изоляцию ветки и защиту секретов. Отчёт сохраняется в ~/.local/share/RepoPilotBridge/doctor/.

Где хранятся данные

Windows

• Список проектов: %APPDATA%\RepoPilotBridge\repos.json
• Настройки RepoPilot: %APPDATA%\RepoPilotBridge\settings.json
• Runtime, virtualenv, логи и установленная копия приложения: %LOCALAPPDATA%\RepoPilotBridge
• Отчёты doctor: %LOCALAPPDATA%\RepoPilotBridge\doctor

macOS

• Список проектов: ~/Library/Application Support/RepoPilotBridge/repos.json
• Настройки RepoPilot: ~/Library/Application Support/RepoPilotBridge/settings.json
• Runtime, virtualenv, логи и установленная копия приложения: ~/.local/share/RepoPilotBridge
• Шим команды repopilot: ~/.local/bin/repopilot
• Ярлык на рабочем столе: ~/Desktop/RepoPilot.command
• Отчёты doctor: ~/.local/share/RepoPilotBridge/doctor

Linux

• Список проектов: ~/.config/RepoPilotBridge/repos.json (или $XDG_CONFIG_HOME)
• Настройки RepoPilot: ~/.config/RepoPilotBridge/settings.json
• Runtime, virtualenv, логи: ~/.local/share/RepoPilotBridge (или $XDG_DATA_HOME)
• Отчёты doctor: ~/.local/share/RepoPilotBridge/doctor

Документация

• QUICKSTART.md — короткий запуск.
• SECURITY.md — модель безопасности и ограничения.
• TROUBLESHOOTING.md — частые ошибки.
• CONTRIBUTING.md — как развивать проект.
• CHANGELOG.md — история заметных изменений.

Лицензия

См. LICENSE.