Tidal Echo — плагин
Плагин-канал Claude Code и PWA на телефоне: личная переписка с сессией агента через ваш сервер, без сторонних сервисов чата
- 340 ★ репозитория
- Последний коммит
- AGPL-3.0
Широкий доступ
Почему такой уровень
- Любой, кто знает `RELAY_SECRET`, шлет сообщения прямо в сессию агента с доступом к файлам и командам компьютера
- Флаг `--dangerously-load-development-channels` и скрипты автоподтверждения снимают штатную защиту диалога
- Публичный relay на VPS хранит всю переписку в SQLite
Установка
- Работает в
Ручная установка
{"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 с вашего компьютера открываются чатом в телефоне
Плагин для Claude Code, который звонит вам по телефону, когда агент закончил задачу, застрял или нужно решение
Личные сообщения, группы и входящие с подтверждением для ИИ-агентов на вашем сервере, бесплатно в пределах лимитов Cloudflare
Мост связывает WeChat, WeCom или Telegram с локальными Codex, Claude Code, OpenCode и Pi, а агентом можно управлять с телефона.
Локальная сеть для кодинг-агентов: Claude Code, Codex, OpenCode и Pi задают друг другу вопросы между проектами и машинами
Agent-Native Agent
Agent-Native Agent (ANA)
Плагин для Claude Code и самостоятельное приложение: дашборд и чат с кодинг-агентом, который переписывает приложение на ходу
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Tidal Echo (эта карточка) | нет | 340 | ||
| Claude Code WeChat Channel | нет | OAuth | 311 | канал через WeChat, у Tidal Echo собственный relay и PWA на вашем сервере |
| Claude Code VKontakte Channel | нет | 2 | канал через сообщество ВКонтакте, у Tidal Echo переписка идет через ваш сервер |
Коротко о README
README на китайском объясняет схему из трех частей, порядок полного развертывания (relay, PWA, плагин), вариант с готовым фронтендом и собственным бэкендом и протокол: три обязательные точки API и необязательные. Отдельный раздел посвящен серверному API-циклу.