Referência CLI

Recursos Principais

Sistema de Arquivos Remoto: Acesse e edite arquivos locais pelo aplicativo móvel Spck Editor
Integração com Git: Operações git completas (commit, push, pull, gerenciamento de branches) — requer Git 2.20.0+
Acesso ao Terminal: Sessões de terminal interativas com xterm.js
Proxy de Navegador: Visualize seu servidor local em uma janela de navegador em tela cheia dentro do Spck Editor
Busca Rápida: Busca de arquivos otimizada com detecção automática do ripgrep (100x mais rápido quando instalado)
Agentes de IA Locais (ACP): Controle Claude Code, Codex ou Gemini CLI a partir do Chat de IA do Spck Editor via Agent Client Protocol. O agente é executado em sua máquina com sua própria assinatura. Veja Agentes de IA no Mobile (ACP).
Seguro: Requisições assinadas criptograficamente com autenticação Firebase opcional

Servidor Relay

O CLI se conecta ao Spck Editor por meio de um servidor relay que encaminha mensagens entre os dois. Na primeira execução, o CLI seleciona automaticamente o servidor relay com menor latência e salva a preferência em ~/.spck-editor/.credentials.json.

IMPORTANTE: Tanto o CLI quanto o cliente Spck Editor precisam usar o mesmo servidor relay para se conectar. Se o cliente não encontrar o CLI, verifique se ambos selecionaram o mesmo servidor relay.

Servidores Relay Disponíveis

Região	URL
Europa	`cli-eu-1.spck.io`
América do Norte	`cli-na-1.spck.io`
Sul da Ásia	`cli-sas-1.spck.io`
Leste da Ásia	`cli-ea-1.spck.io`

Substituindo o Servidor Relay

# Usar um servidor relay específico
spck --server cli-eu-1.spck.io

# Forma abreviada
spck -s cli-na-1.spck.io

A substituição é salva e reutilizada nas execuções seguintes. Para executar a seleção automática novamente, limpe suas credenciais e reinicie:

spck --logout
spck

Escolhendo um Servidor Relay no Spck Editor

Ao conectar pelo aplicativo móvel via Link Remote Server, selecione o mesmo servidor relay no menu suspenso Relay Server que o CLI está usando. O nome do servidor relay é exibido na saída do CLI após a conexão.

Fluxo de Trabalho Diário

Iniciando sua Sessão

cd /path/to/project
spck
# Conecte pelo aplicativo móvel (conecta automaticamente ao servidor salvo)
# Comece a codificar

Editando Arquivos

Navegue pelos arquivos no aplicativo móvel
Toque para abrir e editar
Os arquivos são salvos automaticamente no seu computador

Executando Comandos Git

Opção 1 - Interface gráfica do aplicativo móvel:

Abra o painel Git
Visualize alterações, adicione arquivos ao stage
Faça commit e push

Opção 2 - Terminal:

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

Sessões de Terminal

Toque no ícone de terminal no aplicativo móvel para acesso completo ao shell com as permissões do seu usuário.

Encerrando sua Sessão

# Mantenha o CLI em execução para reconexões rápidas (recomendado)
# Ou pare com Ctrl+C

Resolução de Problemas

Diretório Raiz Não Encontrado

# Reconfigurar com o caminho correto
spck --setup

# Ou especificar diretamente
spck --root /correct/path/to/project

Configuração Corrompida

# Limpar configurações e começar do zero
spck --logout
spck --setup

Problemas de Conexão

Verifique a conexão com a internet
Confirme que tanto o CLI quanto o Spck Editor estão usando o mesmo servidor relay (exibido na saída do CLI após a conexão)
Tente sair e reconectar:
```
spck --logout
spck
```
Verifique as configurações de firewall — certifique-se de que conexões WebSocket (porta 443) são permitidas

QR Code Não Está Sendo Lido

Verifique se o aplicativo Spck Editor está instalado antes de escanear
Use a entrada manual: Projects → New Project → Link Remote Server
Use o aplicativo de câmera nativo, não leitores de terceiros

Operações Git Não Estão Funcionando

Verifique se o Git está instalado:
```
git --version  # Requer 2.20.0+
```

Instale se necessário:

# macOS
brew install git

# Ubuntu/Debian
sudo apt-get install git

# Windows: Baixe em git-scm.com

Desempenho Lento na Busca

Instale o ripgrep para busca 100x mais rápida:

# macOS
brew install ripgrep

# Ubuntu/Debian
sudo apt-get install ripgrep

# Windows (Chocolatey)
choco install ripgrep

# O CLI detecta e usa o ripgrep automaticamente

Permissão Negada

# Ver permissões
ls -la /path/to/file

# Corrigir se necessário
chmod 644 /path/to/file

# Não use sudo - o CLI deve ser executado como o usuário que possui os arquivos

Limites de Conexão

O número máximo de conexões simultâneas do CLI e os limites de uso diário dependem do tipo de conta:

Plano	Conexões CLI	Limite Diário
Gratuito	1	30 minutos
Apoiador	2	Ilimitado
Gold	5	Ilimitado

O uso do plano gratuito é redefinido diariamente à meia-noite UTC.

Quando o limite de conexões é atingido:

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

Quando o limite diário do plano gratuito é atingido:

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

Verifique as conexões ativas:

spck --account

💡 Nota: Apenas um dispositivo móvel pode se conectar a uma instância do CLI por vez. Cada instância do CLI utiliza um slot de conexão.

Suporte

Site: https://spck.io
Suporte: Entre em contato pelo aplicativo móvel Spck Editor