Справочник CLI

Ключевые возможности

Удалённая файловая система: Доступ к локальным файлам и их редактирование из мобильного приложения Spck Editor
Интеграция с Git: Полный набор git-операций (коммит, push, pull, управление ветками) — требуется Git 2.20.0+
Доступ к терминалу: Интерактивные сессии терминала через xterm.js
Браузерный прокси: Предпросмотр локального сервера в полноэкранном браузере внутри Spck Editor
Быстрый поиск: Оптимизированный поиск по файлам с автоматическим определением ripgrep (в 100 раз быстрее при наличии)
Локальные ИИ-агенты для кода (ACP): Управляйте Claude Code, Codex или Gemini CLI из ИИ-чата Spck Editor через Agent Client Protocol. Агент работает на вашей машине с вашей подпиской. См. ИИ-агенты для кода на мобильных устройствах (ACP).
Безопасность: Криптографически подписанные запросы с опциональной аутентификацией Firebase

Сервер ретрансляции

CLI подключается к Spck Editor через сервер ретрансляции, который передаёт сообщения между ними. При первом запуске CLI автоматически выбирает сервер ретрансляции с наименьшей задержкой и сохраняет предпочтение в ~/.spck-editor/.credentials.json.

ВАЖНО: Для подключения и CLI, и клиент Spck Editor должны использовать один и тот же сервер ретрансляции. Если клиент не может найти CLI, убедитесь, что обе стороны выбрали один и тот же сервер ретрансляции.

Доступные серверы ретрансляции

Регион	URL
Европа	`cli-eu-1.spck.io`
Северная Америка	`cli-na-1.spck.io`
Южная Азия	`cli-sas-1.spck.io`
Восточная Азия	`cli-ea-1.spck.io`

Переопределение сервера ретрансляции

# Использовать конкретный сервер ретрансляции
spck --server cli-eu-1.spck.io

# Сокращённая форма
spck -s cli-na-1.spck.io

Переопределение сохраняется и применяется при последующих запусках. Чтобы повторно запустить автоматический выбор, очистите учётные данные и перезапустите:

spck --logout
spck

Выбор сервера ретрансляции в Spck Editor

При подключении из мобильного приложения через Link Remote Server выберите тот же сервер ретрансляции в выпадающем списке Relay Server, который использует CLI. Название сервера ретрансляции отображается в выводе CLI после подключения.

Ежедневная работа

Начало сессии

cd /path/to/project
spck
# Подключитесь из мобильного приложения (автоматически подключается к сохранённому серверу)
# Начните писать код

Редактирование файлов

Просматривайте файлы в мобильном приложении
Нажмите, чтобы открыть и редактировать
Файлы автоматически сохраняются на вашем компьютере

Выполнение git-команд

Вариант 1 — Графический интерфейс мобильного приложения:

Откройте панель Git
Просмотрите изменения, добавьте файлы
Создайте коммит и выполните push

Вариант 2 — Терминал:

git status
git add .
git commit -m "Update feature"
git push

Сессии терминала

Нажмите на значок терминала в мобильном приложении для полного доступа к оболочке с вашими правами пользователя.

Завершение сессии

# Оставьте CLI запущенным для быстрого переподключения (рекомендуется)
# Или остановите с помощью Ctrl+C

Устранение неполадок

Корневая директория не найдена

# Перенастройте с правильным путём
spck --setup

# Или укажите напрямую
spck --root /correct/path/to/project

Повреждённая конфигурация

# Очистите настройки и начните заново
spck --logout
spck --setup

Проблемы с подключением

Проверьте интернет-соединение
Убедитесь, что CLI и Spck Editor используют один и тот же сервер ретрансляции (отображается в выводе CLI после подключения)
Попробуйте выйти и переподключиться:
```
spck --logout
spck
```
Проверьте настройки брандмауэра — убедитесь, что WebSocket-соединения (порт 443) разрешены

QR-код не сканируется

Убедитесь, что приложение Spck Editor установлено до сканирования
Используйте ручной ввод: Projects → New Project → Link Remote Server
Используйте встроенное приложение «Камера», а не сторонние сканеры

Git-операции не работают

Убедитесь, что Git установлен:
```
git --version  # Требуется 2.20.0+
```

При необходимости установите:

# macOS
brew install git

# Ubuntu/Debian
sudo apt-get install git

# Windows: скачайте с git-scm.com

Медленная работа поиска

Установите ripgrep для поиска в 100 раз быстрее:

# macOS
brew install ripgrep

# Ubuntu/Debian
sudo apt-get install ripgrep

# Windows (Chocolatey)
choco install ripgrep

# CLI автоматически определяет и использует ripgrep

Отказано в доступе

# Просмотр прав доступа
ls -la /path/to/file

# Исправление при необходимости
chmod 644 /path/to/file

# Не используйте sudo — CLI должен запускаться от имени пользователя, владеющего файлами

Ограничения подключений

Максимальное количество одновременных CLI-подключений и суточные лимиты использования зависят от типа вашего аккаунта:

Тариф	CLI-подключения	Суточный лимит
Free	1	30 минут
Supporter	2	Без ограничений
Gold	5	Без ограничений

Использование бесплатного тарифа сбрасывается ежедневно в 00:00 UTC.

При достижении лимита подключений:

⚠️  Maximum of X CLI connections reached.
Close other CLI instances and try again.

При достижении суточного лимита бесплатного тарифа:

⚠️  Daily free tier limit of 30 minutes has been reached.
Upgrade to continue using CLI.

Проверка активных подключений:

spck --account

💡 Примечание: К одному экземпляру CLI одновременно может подключиться только одно мобильное устройство. Каждый экземпляр CLI занимает один слот подключения.

Поддержка

Сайт: https://spck.io
Поддержка: Свяжитесь через мобильное приложение Spck Editor