Dropstone CLI

Solução de problemas

Problemas comuns e como resolvê-los.

Para depurar problemas com o Dropstone, comece verificando os logs e os dados locais que ele armazena no disco.

Logs

Os arquivos de log são gravados em:

  • macOS / Linux: ~/.local/share/dropstone/log/
  • Windows: pressione WIN+R e cole %USERPROFILE%\.local\share\dropstone\log

Os arquivos de log são nomeados com carimbos de data/hora (por exemplo, 2026-05-23T123456.log) e os 10 arquivos de log mais recentes são mantidos.

Você pode definir o nível de log com a opção de linha de comando --log-level para obter uma saída de depuração mais detalhada:

dropstone --log-level DEBUG

--print-logs também transmite logs para stderr em tempo real:

dropstone --print-logs

Armazenamento

O Dropstone armazena dados de sessão e outros dados de aplicativo no disco em:

  • macOS / Linux: ~/.local/share/dropstone/
  • Windows: pressione WIN+R e cole %USERPROFILE%\.local\share\dropstone

Este diretório contém:

  • auth.json: Credenciais de autenticação
  • log/: Logs do aplicativo
  • project/: Dados específicos do projeto, como histórico de sessão
    • Se o projeto estiver dentro de um repositório Git, ele é armazenado em ./<project-slug>/storage/
    • Caso contrário, é armazenado em ./global/storage/

Problemas comuns

O Dropstone não inicia

  1. Verifique os logs para ver se há uma mensagem de erro.
  2. Tente executar com --print-logs para transmitir logs para stderr.
  3. Certifique-se de estar na versão mais recente: dropstone update.

Se ele morrer instantaneamente sem imprimir nada no macOS, isso é uma falha diferente — veja Encerrado na inicialização no macOS.

Encerrado na inicialização no macOS

No Apple Silicon, o Dropstone 1.0.50 foi encerrado pelo macOS antes de imprimir qualquer coisa, então todos os comandos pareciam assim:

dropstone --version
# zsh: killed     dropstone --version

Não há log para ler nem erro para pesquisar: o processo é interrompido antes de iniciar, e é por isso que --print-logs e dropstone upgrade também são encerrados. O macOS valida a assinatura do binário antes de executá-lo, e a assinatura gravada nessa versão não correspondia. O macOS até a versão 26 tolerava isso; o macOS 27 não tolera. Windows e Linux nunca foram afetados.

Para confirmar antes de reinstalar:

codesign --verify --verbose=4 "$(readlink -f "$(which dropstone)")"
# /opt/homebrew/bin/dropstone: invalid signature (code or signature have been modified)

Em seguida, substitua o binário. Tanto o Homebrew quanto o instalador funcionam sem que a cópia instalada esteja em execução:

# Homebrew
brew update && brew upgrade dropstone

# O instalador de uma linha
curl -fsSL https://dropstone.io/install.sh | bash

Para desbloquear a cópia que você já tem em vez de reinstalar:

codesign --force --sign - "$(readlink -f "$(which dropstone)")"

As versões 1.0.51 e posteriores são assinadas de uma forma que o macOS aceita, e cada versão verifica essa assinatura antes de ser publicada.

Problemas de autenticação

Se o login ou a validação do token falhar:

  1. Execute dropstone novamente e faça login pelo fluxo do navegador.
  2. Se você estiver em um ambiente sem interface gráfica, defina DROPSTONE_API_KEY com um token emitido em dropstone.io/account.
  3. Confirme se sua rede permite HTTPS de saída para dropstone.io. Se você estiver atrás de um proxy corporativo, veja Rede.

Modelo não encontrado

Se você vir ModelNotFoundError, provavelmente está referenciando um ID de modelo que não existe. Use um dos seguintes:

  • dropstone/dropstone-fast
  • dropstone/dropstone-pro
  • dropstone/dropstone-heavy

Execute dropstone models para confirmar o que está disponível para sua conta.

Erro de inicialização

Se você vir um InitError ao iniciar, suas credenciais armazenadas podem estar inválidas ou corrompidas.

  1. Limpe seus dados armazenados:

    rm -rf ~/.local/share/dropstone

    No Windows: pressione WIN+R e exclua %USERPROFILE%\.local\share\dropstone.

  2. Execute dropstone novamente e faça login.

Erros de chamada de API

Se você vir erros de chamada de API durante uma sessão, o cache em disco pode estar desatualizado.

  1. Limpe o cache:

    rm -rf ~/.cache/dropstone

    No Windows: pressione WIN+R e exclua %USERPROFILE%\.cache\dropstone.

  2. Reinicie o Dropstone.

Copiar / colar não funciona no Linux

Usuários de Linux precisam de um dos seguintes utilitários de área de transferência instalados para que copiar/colar funcione:

X11

apt install -y xclip
# ou
apt install -y xsel

Wayland

apt install -y wl-clipboard

Sem interface gráfica

apt install -y xvfb
# depois
Xvfb :99 -screen 0 1024x768x24 > /dev/null 2>&1 &
export DISPLAY=:99.0

O Dropstone prefere wl-clipboard no Wayland e usa xclip e depois xsel como fallback no X11.

Windows: Problemas gerais de desempenho

Se você estiver enfrentando desempenho lento, problemas de acesso a arquivos ou falhas no terminal no Windows nativo, mude para WSL. O WSL oferece um ambiente Linux que executa o Dropstone com velocidade nativa do sistema de arquivos e suporte completo ao terminal.

Obtendo ajuda

Ctrl+I