Урок 5. Работа с терминалом удалённо#

Зачем это нужно#

Вы начали задачу на рабочем компьютере, но нужно уйти. С HAPI вы можете продолжить управлять AI-агентом с телефона — отправлять команды, одобрять действия и следить за прогрессом. Это как пульт дистанционного управления для вашего терминала.

Два режима работы#

HAPI поддерживает два режима, между которыми можно переключаться мгновенно:

Локальный режим (в терминале)#

Вы сидите за компьютером и работаете как обычно
Полный интерфейс терминала с подсветкой синтаксиса
Мгновенный отклик на нажатия клавиш
AI-агент работает прямо на вашей машине

Удалённый режим (с телефона/браузера)#

Управление через Web App из любой точки мира
Одобрение разрешений одним нажатием
Мониторинг прогресса в реальном времени
Сессия продолжает работать на вашем компьютере

Как переключаться между режимами#

Из терминала → на телефон#

Просто отправьте сообщение с телефона (через Web App). Терминал автоматически перейдёт в режим ожидания и покажет:

Remote mode - waiting for input

Всё! Теперь управление на стороне телефона.

С телефона → в терминал#

Нажмите двойной пробел в терминале. Мгновенно вернётесь к локальному управлению — как будто никуда не уходили.

💡 Сессия одна и та же — переключение не теряет контекст, историю и состояние.

Запуск команд с телефона#

Шаг 1: Убедитесь, что Hub и Runner запущены#

hapi hub --relay           # Hub с доступом через интернет
hapi runner start          # Фоновый сервис для удалённого запуска

Шаг 2: Откройте Web App на телефоне#

Отсканируйте QR-код, который показал Hub, или перейдите по URL.

Шаг 3: Управляйте сессиями#

В Web App вы можете:

Открыть существующую сессию — нажмите на неё в списке
Создать новую сессию — нажмите кнопку «New Session» и выберите машину
Отправить сообщение агенту — напишите в поле ввода, как в обычном мессенджере
Просмотреть файлы — откройте файловый браузер сессии
Посмотреть изменения кода — git-диффы прямо в интерфейсе

AFK-режим: «Ушёл от клавиатуры»#

AFK (Away From Keyboard — ушёл от клавиатуры) — это сценарий, для которого HAPI создан:

Типичный сценарий#

09:00  Вы за компьютером. Запускаете: hapi
       Даёте задачу: «Рефакторить модуль оплаты»
       
09:10  Уходите за кофе ☕
       
09:12  Агент хочет изменить файл payment.ts
       → Уведомление на телефон!
       → Открываете Web App → Нажимаете «Одобрить» ✅
       
09:15  Агент хочет запустить тесты
       → Уведомление на телефон
       → «Одобрить» ✅
       
09:20  Возвращаетесь к компьютеру
       → Двойной пробел → снова в терминале
       → Агент уже всё сделал! 🎉

Одобрение действий#

Когда AI-агент хочет выполнить потенциально опасное действие (изменить файл, запустить команду), он запрашивает ваше разрешение.

Как выглядит запрос разрешения#

В Web App вы увидите:

Что хочет сделать агент (например, «Edit file: src/payment.ts»)
Детали — какие именно изменения предлагаются
Кнопки Approve (одобрить) и Deny (отклонить)

Способы одобрения#

Способ	Как
Web App	Нажмите кнопку «Approve» или «Deny»
Telegram	Получите уведомление от бота, ответьте
Голос	Скажите «да» или «нет» голосовому ассистенту
Терминал	Если вы за компьютером — подтвердите как обычно

Удалённый запуск сессий#

С Runner вы можете создавать новые сессии прямо с телефона, даже если на компьютере не открыт терминал.

Как это работает#

Runner работает в фоне на вашем компьютере
В Web App нажмите «+» (новая сессия)
Выберите машину из списка
Выберите AI-агента (Claude, Codex, Gemini)
Опционально: укажите рабочую папку
Сессия запустится на вашем компьютере — управляйте с телефона!

Телефон → Web App → Hub → Runner → Новая сессия CLI
                                         │
                                    AI-агент работает
                                    на вашем компьютере

Практические советы#

1. Настройте уведомления#

Подключите Telegram-бота, чтобы получать push-уведомления:

export TELEGRAM_BOT_TOKEN="ваш-токен"
hapi hub --relay

Теперь запросы на разрешения будут приходить прямо в Telegram — не нужно постоянно держать Web App открытым.

2. Установите PWA#

Откройте Web App в мобильном браузере и «Добавьте на главный экран». Приложение будет работать как обычное — с иконкой, полноэкранным режимом и быстрым доступом.

3. Используйте pm2 для надёжности#

pm2 start "hapi hub --relay" --name hapi-hub
pm2 start "hapi runner start --foreground" --name hapi-runner
pm2 save

Так Hub и Runner будут работать постоянно, даже после перезагрузки компьютера.

4. Несколько машин#

Если у вас несколько компьютеров (рабочий + домашний), установите CLI и Runner на каждом и подключите их к одному Hub. В Web App вы увидите все машины и сможете запускать сессии на любой из них.

Итоги урока#

HAPI позволяет управлять AI-агентом с телефона — отправлять задачи и одобрять действия
Переключение между терминалом и телефоном — мгновенное (двойной пробел)
AFK-режим — уходите от компьютера, а агент продолжает работать; вы одобряете действия с телефона
Runner позволяет запускать новые сессии удалённо
Уведомления можно получать через Telegram, Web App или голосовой ассистент
Установите PWA и pm2 для максимально удобной работы