Dropstone CLI

Solución de problemas

Problemas comunes y cómo resolverlos.

Para depurar problemas con Dropstone, comienza revisando los registros y los datos locales que almacena en el disco.

Registros

Los archivos de registro se escriben en:

  • macOS / Linux: ~/.local/share/dropstone/log/
  • Windows: presiona WIN+R y pega %USERPROFILE%\.local\share\dropstone\log

Los archivos de registro se nombran con marcas de tiempo (por ejemplo 2026-05-23T123456.log) y se conservan los 10 archivos de registro más recientes.

Puedes configurar el nivel de registro con la opción de línea de comandos --log-level para obtener una salida de depuración más detallada:

dropstone --log-level DEBUG

--print-logs también transmite los registros a stderr en tiempo real:

dropstone --print-logs

Almacenamiento

Dropstone almacena datos de sesión y otros datos de la aplicación en el disco en:

  • macOS / Linux: ~/.local/share/dropstone/
  • Windows: presiona WIN+R y pega %USERPROFILE%\.local\share\dropstone

Este directorio contiene:

  • auth.json: Credenciales de autenticación
  • log/: Registros de la aplicación
  • project/: Datos específicos del proyecto, como el historial de sesiones
    • Si el proyecto está dentro de un repositorio Git, se almacena en ./<project-slug>/storage/
    • De lo contrario, se almacena en ./global/storage/

Problemas comunes

Dropstone no se inicia

  1. Revisa los registros para ver si hay un mensaje de error.
  2. Intenta ejecutar con --print-logs para transmitir los registros a stderr.
  3. Asegúrate de estar en la última versión: dropstone update.

Si se cierra instantáneamente sin imprimir nada en macOS, se trata de un fallo diferente: consulta Terminado al iniciar en macOS.

Terminado al iniciar en macOS

En Apple Silicon, Dropstone 1.0.50 fue terminado por macOS antes de imprimir nada, por lo que cada comando se veía así:

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

No hay ningún registro que leer ni ningún error que buscar: el proceso se detiene antes de iniciarse, por lo que --print-logs y dropstone upgrade también se ven afectados. macOS valida la firma del binario antes de ejecutarlo, y la que estaba incluida en esa compilación no coincidía. macOS hasta la versión 26 lo toleraba; macOS 27 no. Windows y Linux nunca se vieron afectados.

Para confirmarlo antes de reinstalar:

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

Luego reemplaza el binario. Tanto Homebrew como el instalador funcionan sin necesidad de ejecutar la copia instalada:

# Homebrew
brew update && brew upgrade dropstone

# El instalador de una línea
curl -fsSL https://dropstone.io/install.sh | bash

Para desbloquear la copia que ya tienes en lugar de reinstalar:

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

Las versiones 1.0.51 y posteriores están firmadas de una manera que macOS acepta, y cada versión verifica esa firma antes de publicarse.

Problemas de autenticación

Si el inicio de sesión o la validación del token falla:

  1. Vuelve a ejecutar dropstone e inicia sesión nuevamente mediante el flujo del navegador.
  2. Si estás en un entorno sin interfaz gráfica, configura DROPSTONE_API_KEY con un token emitido en dropstone.io/account.
  3. Confirma que tu red permite conexiones HTTPS salientes a dropstone.io. Si estás detrás de un proxy corporativo, consulta Red.

Modelo no encontrado

Si ves ModelNotFoundError, es probable que estés haciendo referencia a un ID de modelo que no existe. Usa uno de los siguientes:

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

Ejecuta dropstone models para confirmar qué modelos están disponibles para tu cuenta.

Error de inicialización

Si ves un InitError al iniciar, es posible que tus credenciales almacenadas sean inválidas o estén corruptas.

  1. Borra tus datos almacenados:

    rm -rf ~/.local/share/dropstone

    En Windows: presiona WIN+R y elimina %USERPROFILE%\.local\share\dropstone.

  2. Vuelve a ejecutar dropstone e inicia sesión nuevamente.

Errores de llamadas a la API

Si ves errores de llamadas a la API durante una sesión, es posible que la caché en disco esté desactualizada.

  1. Borra la caché:

    rm -rf ~/.cache/dropstone

    En Windows: presiona WIN+R y elimina %USERPROFILE%\.cache\dropstone.

  2. Reinicia Dropstone.

Copiar / pegar no funciona en Linux

Los usuarios de Linux necesitan una de las siguientes utilidades de portapapeles instaladas para que copiar/pegar funcione:

X11

apt install -y xclip
# o
apt install -y xsel

Wayland

apt install -y wl-clipboard

Sin interfaz gráfica

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

Dropstone prefiere wl-clipboard en Wayland y recurre a xclip y luego a xsel en X11.

Windows: Problemas generales de rendimiento

Si experimentas un rendimiento lento, problemas de acceso a archivos o fallos en la terminal en Windows nativo, cambia a WSL. WSL te proporciona un entorno Linux que ejecuta Dropstone con la velocidad nativa del sistema de archivos y soporte completo de terminal.

Obtener ayuda

Ctrl+I