Tidal Echo — плагин

Плагин-канал Claude Code и PWA на телефоне: личная переписка с сессией агента через ваш сервер, без сторонних сервисов чата

  • 340 ★ репозитория
  • Последний коммит
  • AGPL-3.0
Плагин

Широкий доступ

Почему такой уровень

  • Любой, кто знает `RELAY_SECRET`, шлет сообщения прямо в сессию агента с доступом к файлам и командам компьютера
  • Флаг `--dangerously-load-development-channels` и скрипты автоподтверждения снимают штатную защиту диалога
  • Публичный relay на VPS хранит всю переписку в SQLite
Все причины и проверки

anhe2021212-spec/tidal_echo

Установка

Работает в

Ручная установка

{"mcpServers": {"companion": {"command": "bun", "args": ["run", "--cwd", "/абсолютный/путь/companion-channel", "--silent", "start"]}}}

Сначала поднимите relay и положите ключ в `~/.claude/channels/companion/.env`. Нужен Bun.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Любой, кто знает `RELAY_SECRET`, шлет сообщения прямо в сессию агента с доступом к файлам и командам компьютера
  • Флаг `--dangerously-load-development-channels` и скрипты автоподтверждения снимают штатную защиту диалога
  • Публичный relay на VPS хранит всю переписку в SQLite

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Tidal Echo соединяет телефон с запущенной на компьютере сессией Claude Code. Репозиторий состоит из трех частей: `backend/` (relay на FastAPI с SQLite, раздает сообщения по SSE), `web/` (PWA на одной HTML-странице, ставится на главный экран) и `channel/` (плагин для Claude Code на Bun и MCP). Сообщение с телефона появляется в сессии блоком `<channel>`, агент отвечает вызовом инструмента `reply`, и ответ приходит на телефон сообщением в чате. Доступ защищает один общий секрет `RELAY_SECRET`: учетных записей и стороннего хостинга нет, сообщения проходят только через ваш сервер. Голос через MiniMax и Web Push необязательны, с пустыми настройками они отключаются. Вместо Claude Code подключается любая модель с OpenAI-совместимым API: скрипт `examples/bridge_any_llm.py` заменяет сторону ИИ. Скрипт `examples/api_loop.py` держит на сервере постоянного агента с цепочкой запасных моделей, картинками и вложениями, MCP-инструментами по stdio или streamable-http и файлом системного промпта, который перечитывается без перезапуска.

Для кого. Тем, кто пишет своей сессии Claude Code с телефона и хранит переписку только на собственном сервере.

Подходит, если

  • Сессия Claude Code идет на домашнем компьютере, а ответы нужны на телефоне с пушем
  • Переписка с ИИ хранится только на вашем VPS, без стороннего хостинга чата
  • Claude Code заменяют на GPT, DeepSeek или Gemini: клиент остается, ИИ-сторона уходит в `bridge_any_llm.py`
  • Серверу нужен постоянный агент с MCP-инструментами и вложениями: для этого служит `api_loop.py`

Не подходит, если

  • Нужен готовый облачный сервис: придется поднимать relay, nginx, службу systemd и домен с HTTPS
  • Чатом пользуются несколько человек: система рассчитана на одного пользователя и один ключ
  • Запуск без подтверждений в автоматике недопустим: Claude Code с флагом `--dangerously-load-development-channels` спрашивает подтверждение при каждом старте
  • Нужен только чат с моделью по API без Claude Code: подойдут готовые клиенты

Пример запроса к агенту

Разверни Tidal Echo по AGENTS.md: relay на моем VPS, PWA на домене, плагин в Claude Code, и проверь связку сообщением с телефона

Ограничения

  • Система рассчитана на одного пользователя с одним секретом `RELAY_SECRET`, учетных записей нет.
  • PWA требует домен с HTTPS: без него не работают установка, service worker и Web Push.
  • Claude Code запускают с флагом `--dangerously-load-development-channels server:companion`, и каждый старт показывает диалог подтверждения. Для автоматического ответа в репозитории лежат скрипты под tmux и Windows.
  • Документация на китайском, последний коммит в сентябре 2026 года.

Как отключить. Закройте сессию Claude Code, запущенную с флагом `--dangerously-load-development-channels`, и удалите ключ companion из `.mcp.json`. Остановите службу relay командой `systemctl disable --now companion-relay`, затем удалите `~/.claude/channels/companion/.env` и базу SQLite на сервере.

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

Как подключить Tidal Echo к Claude Code?

Скопируйте папку `channel/` на компьютер, пропишите `RELAY_SECRET` в `~/.claude/channels/companion/.env`, зарегистрируйте сервер companion в `.mcp.json` с командой `bun` и запустите `claude --dangerously-load-development-channels server:companion`. Подробности лежат в `channel/DEPLOY.md`.

Можно ли взять другую модель вместо Claude?

Можно. Фронтенд и relay остаются, а сторону ИИ заменяет скрипт `examples/bridge_any_llm.py` для любого OpenAI-совместимого API.

Нужен ли собственный сервер?

Да. Relay и PWA размещают на вашем VPS с доменом под HTTPS: без него не работают установка PWA, service worker и Web Push.

Работают ли голос и пуш-уведомления?

Да, как необязательные функции: голос через MiniMax и Web Push на экране блокировки включаются настройками. С пустыми настройками чат работает без них.

Можно ли подключить MCP-инструменты?

Через `examples/api_loop.py`: серверный агент подключает MCP-серверы по stdio или streamable-http и показывает каждый шаг вызова в чате.

Обсуждение

Вопросов и отзывов пока нет.

Плагины

Мост-сервер и мобильное приложение: сессии Claude Code и Codex с вашего компьютера открываются чатом в телефоне

CLIШирокий доступ1,1 тыс.Звезды репозитория
Нужен VPN

Плагин для Claude Code, который звонит вам по телефону, когда агент закончил задачу, застрял или нужно решение

ПлагинШирокий доступ2,7 тыс.Звезды репозитория

Личные сообщения, группы и входящие с подтверждением для ИИ-агентов на вашем сервере, бесплатно в пределах лимитов Cloudflare

СкиллШирокий доступ162Звезды репозитория

Мост связывает WeChat, WeCom или Telegram с локальными Codex, Claude Code, OpenCode и Pi, а агентом можно управлять с телефона.

CLIШирокий доступ563Звезды репозитория

Локальная сеть для кодинг-агентов: Claude Code, Codex, OpenCode и Pi задают друг другу вопросы между проектами и машинами

CLIШирокий доступ272Звезды репозитория

Agent-Native Agent

Agent-Native Agent (ANA)

Плагин для Claude Code и самостоятельное приложение: дашборд и чат с кодинг-агентом, который переписывает приложение на ходу

ПлагинШирокий доступ130Звезды репозитория

Сравнение с похожими

Карточки с тем же главным запросом: чем они отличаются.

ИнструментОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
Tidal Echo (эта карточка)нет340
Claude Code WeChat ChannelнетOAuth311канал через WeChat, у Tidal Echo собственный relay и PWA на вашем сервере
Claude Code VKontakte Channelнет2канал через сообщество ВКонтакте, у Tidal Echo переписка идет через ваш сервер

Коротко о README

README на китайском объясняет схему из трех частей, порядок полного развертывания (relay, PWA, плагин), вариант с готовым фронтендом и собственным бэкендом и протокол: три обязательные точки API и необязательные. Отдельный раздел посвящен серверному API-циклу.

Бейдж для README

Сообщить о проблеме

Foxx AITidal Echo
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.