Skip to content

Repository files navigation

Логотип Remcli

Remcli

Телефон — в руке, код — дома.

Remote CLI для AI coding-агентов: управляйте рабочими сессиями, терминалами и задачами с телефона или браузера.

Подключение Remcli по QR-коду

Один рабочий стол — на любом экране

Remcli даёт полноценный desktop-режим для работы за компьютером и компактный интерфейс для телефона. Запускайте несколько AI-сессий параллельно, сразу видьте их состояние и возвращайтесь к нужной работе без поиска терминала.

Полноценный desktop-режим Remcli

  • Создавайте сессии из нужной папки проекта.
  • Выбирайте доступные модели, уровень размышления и права доступа агента.
  • Открывайте, останавливайте и возобновляйте прошлые сессии.
  • Начните работу за компьютером, продолжите с телефона и вернитесь к ней в терминале. Для Codex это одна нативная сессия на обоих экранах.

Из дома, офиса и дороги

Основной сценарий для удалённой работы — npm run start:tunnel: при установленном cloudflared Remcli открывает HTTPS Cloudflare Tunnel, и вы управляете своим AI-агентом с телефона из любого места. Если tunnel недоступен, Remcli остаётся в локальном режиме; в одной Wi-Fi сети достаточно npm start.

Никаких аккаунтов Remcli

Ни почты, ни пароля, ни отдельного сервиса с вашей перепиской. QR-код безопасно связывает телефон с вашим компьютером по личному секретному ключу. Проект и агент остаются на вашей машине, а содержимое сообщений и сессий шифруется.

Диалог с Codex в Remcli

Все рабочие сессии под рукой

На одном экране видно, кто работает, кто ждёт разрешения, где произошла ошибка и к какой задаче нужно вернуться. Управляйте несколькими параллельными сессиями, даже когда компьютера нет рядом.

Список активных сессий Remcli на телефоне

Интеграции

AI CLI Готовность Что уже можно
Codex CLI Полный рабочий цикл: новая сессия из папки проекта, общий чат телефона и терминала, tool calls, запросы разрешений, остановка и resume без потери контекста.
Cursor CLI Официальный ACP transport: запуск и строгий resume с контекстом, streaming, tool calls, запросы разрешений, модели и режимы установленного Cursor CLI.
Antigravity agy через stream-json: динамический catalog аккаунта, exact conversation resume, модели и provider-native controls.
Claude Code terminal wrapper доступен; phone/Web deferred npm run claude и runClaude остаются доступны в терминале. Phone/Web provider flow отключён до отдельной provider-specific приёмки.

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

Нужны Node.js 20+, установленный CLI выбранного AI-провайдера и tmux для управляемых сессий. Для удалённого режима нужен cloudflared. Remcli запускается на macOS и Linux; на Windows используйте WSL с tmux. ffmpeg нужен только для голосовых функций.

git clone https://github.com/spetrosyan94/remcli.git
cd remcli
npm run setup
npm run start:tunnel

npm run setup установит зависимости, соберёт проект и откроет мастер настройки. После запуска отсканируйте QR-код, выберите провайдера и папку проекта — сессия готова к работе.

Создание AI-сессии в Remcli

Команда Что делает
npm run setup Устанавливает зависимости, собирает проект и открывает мастер настройки.
npm run start:tunnel Основной удалённый режим: при установленном cloudflared запускает HTTPS Cloudflare Tunnel.
npm start Локальный режим для одной Wi-Fi сети без tunnel.
npm run status Показывает состояние daemon и запущенных процессов.
npm run autostart:install:tunnel Включает запуск Remcli при входе текущего пользователя сразу с удалённым HTTPS-режимом (macOS/Linux/Windows).
npm run autostart:status Проверяет автозапуск и обнаруживает устаревший путь Node/Remcli.
npm run autostart:uninstall Удаляет только созданный Remcli user-level автозапуск.
npm run qr Показывает QR-код повторно.
npm run doctor Проверяет окружение и установленные AI CLI.
npm run stop Останавливает daemon.

Не просто чат — полный контроль агента

Пишите агенту, следите за ходом работы и вмешивайтесь в нужный момент. Remcli показывает не только ответы, но и реальную работу AI на вашем компьютере.

  • Поток ответов, tool calls, ошибки и статус выполнения в одном чате.
  • Запросы разрешений на команды и изменения: разрешайте или отклоняйте действие с телефона.
  • Выбор модели, уровня размышления и доступа там, где это поддерживает AI CLI.
  • Запуск из конкретной директории, resume прошлых сессий и управление несколькими активными задачами.

Дополнительные возможности

Возможность Для чего нужна
Джарвис Компактный локальный помощник для базовых операций: узнать, что запущено, получить статус или попросить открыть сессию.
Whisper Голосовой ввод в чат на локальной модели.
Edge TTS Озвучивание ответов без установки большой локальной модели.
Qwen3 TTS Локальная озвучка и voice profiles на Apple Silicon.

Джарвис выключен по умолчанию: запустите компактную модель в LM Studio и включите его в ~/.remcli/setup.json.

Настройки Remcli в светлой теме

Что внутри

Телефон или браузерлокальный Remcli на вашем компьютереCLI выбранного AI-провайдера.

У Remcli нет своей облачной базы сессий: проект и агент остаются на вашем компьютере. В локальной сети телефон подключается напрямую; для удалённого доступа используется Cloudflare Tunnel. Содержимое сообщений и сессий шифруется между web-клиентом и Remcli на вашем компьютере.

Стек: TypeScript, React 19, Vite, Tailwind CSS, Radix UI, Zustand, Fastify, Socket.IO, Zod, Ink, ACP/MCP.

Roadmap

  • Принять отдельный Claude Code provider capability/lifecycle contract для phone/Web flow.
  • Отдельно спроектировать безопасный live web terminal.
  • При подтверждённой необходимости добавить durable cross-runner recovery для редкого Cursor failure window.

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

Лицензия

MIT

About

Remote CLI

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages