Помощь и частые вопросы

Всё, что нужно для старта с TermBuddy, и ответы на самые частые вопросы.

Быстрый старт

1. Добавьте сервер

Откройте TermBuddy, нажмите «Добавить сервер» и укажите адрес, SSH-порт и имя пользователя с паролем или SSH-ключом. Больше ничего не нужно: TermBuddy подключится по SSH и сам установит на сервер свой небольшой помощник.

2. Создайте Buddy

Buddy — это постоянный сеанс на вашем сервере, показанный как чат. Создайте терминальный Buddy, чтобы отправлять команды как сообщения, или ИИ-Buddy (Claude Code, Codex или Gemini), работающий в выбранной вами папке проекта.

3. Общайтесь

Отправляйте команды или инструкции — вывод возвращается ответами. Приложение можно закрыть в любой момент: длинные задачи продолжают выполняться на сервере, а по завершении придёт push-уведомление.

Частые вопросы

Что такое TermBuddy?

TermBuddy превращает удалённые серверы в чаты на iPhone и Mac. Сеансы терминала и ИИ-агенты (Claude Code, Codex, Gemini CLI) становятся «бадди», которым вы пишете. Сеансы живут на сервере, поэтому работа продолжается, даже когда телефон лежит в кармане.

Это безопасно? Какие порты нужно открывать?

Только SSH (обычно порт 22) — тот же, которым вы уже пользуетесь. Помощник, который TermBuddy ставит на сервер, слушает исключительно 127.0.0.1 и никогда не доступен из интернета; весь трафик идёт через ваше SSH-соединение. Учётные данные хранятся в системной связке ключей устройства, и ничего не проходит через сторонние серверы.

Что нужно на сервере?

Сервер на Linux или macOS с доступом по SSH. Ручная настройка не нужна: TermBuddy сам загрузит и настроит помощник. Для ИИ-бадди дополнительно требуется установленная и авторизованная на сервере ИИ-CLI (например, Claude Code) — на странице сервера есть пошаговый установщик и для неё.

Какие ИИ-ассистенты поддерживаются?

Claude Code, OpenAI Codex CLI и Google Gemini CLI. ИИ работает на вашем сервере в выбранной рабочей папке, с собственной авторизацией и оплатой (например, через ваш аккаунт Anthropic). TermBuddy — это пульт: планы, задачи, вопросы и результаты приходят сообщениями в чат.

Команды прерываются, если закрыть приложение?

Нет. Сеансы живут на сервере. Закройте приложение, потеряйте связь, смените устройство — вернувшись, вы увидите всю историю. Push-уведомления сообщат, когда длинная задача завершится или упадёт.

Что такое библиотека памяти (Experience)?

Личная база знаний с предпочтениями, заметками по проектам и накопленным опытом, которая автоматически синхронизируется с Mac на все серверы, чтобы её мог использовать любой ИИ-бадди. Существующую память Claude можно импортировать одним касанием, а функция «Категоризация» попросит ИИ разложить всё по тематическим папкам.

Что такое Skills?

Многоразовые наборы инструкций (код-ревью, системная отладка, TDD, анализ данных, научное письмо и другие), которые учат ИИ-бадди хорошо выполнять определённые задачи. Включите их во вкладке Skills в приложении для Mac: они сами разворачиваются на все серверы, а ИИ выбирает подходящий, когда запрос совпадает.

Buddy завис на «Обработка…», что делать?

Откройте вкладку «Серверы» и проверьте состояние сервера. Перезапуск помощника TermBuddy оттуда решает большинство случаев; если красная точка сообщает об обновлении — обновите помощник. Также убедитесь на странице сервера, что ИИ-CLI установлена и выполнен вход.

Не удаётся подключиться к серверу.

Сначала проверьте, что обычный SSH работает из другого терминала с теми же хостом, портом, пользователем и учётными данными. Если SSH работает, а TermBuddy нет, посмотрите состояние во вкладке «Серверы» и лог на сервере: ~/.termbuddy/termbuddy.log.

Как происходят обновления?

Приложения обновляются через App Store. Серверный помощник обновляется из приложения: красная точка на вкладке «Серверы» означает, что доступна новая версия, и одно касание установит её по SSH.

Какие данные вы собираете?

Ваше устройство общается с сервером напрямую, без промежуточных узлов. Мы никогда не видим ваши учётные данные, команды, вывод или файлы. Подробности — в политике конфиденциальности.

Где получить поддержку?

Напишите на atlai@atlai.co.uk или воспользуйтесь «Отправить отзыв» в приложении. Особенно полезны сообщения об ошибках с логом сервера (~/.termbuddy/termbuddy.log).