Dropstone CLI

Guía de resolución de problemas

Diagnostica los problemas de Dropstone CLI de forma sistemática. Recopila la información correcta, encuentra los registros y aísla la causa antes de contactar con el soporte.

La mayoría de los problemas se reducen a una de cuatro cosas: una versión desactualizada, una caché obsoleta, credenciales incorrectas o la red. Esta página es el orden en el que debes revisarlas, y qué recopilar cuando ninguna de ellas es la causa.

Para un mensaje de error específico, empieza por Problemas comunes. Para el comportamiento en tiempo de ejecución y la depuración por función, consulta Solución de problemas de CLI.

Primeras tres cosas que probar

Ejecuta estas antes que cualquier otra cosa. Resuelven una parte sorprendente de los informes.

# 1. Actualízate
dropstone update

# 2. Mira qué está haciendo Dropstone realmente
dropstone --log-level DEBUG --print-logs
  1. Si el fallo ocurre a mitad de sesión y la causa no está clara, limpia la caché y reinicia:
rm -rf ~/.cache/dropstone

En Windows, pulsa WIN+R y elimina %USERPROFILE%\.cache\dropstone.

Antes de eliminar cualquier otra cosa

Los tres comandos anteriores son seguros. Eliminar ~/.local/share/dropstone no lo es: ahí es donde viven tus credenciales y el historial de sesiones. Consulta Dónde se guarda el estado antes de eliminar ese directorio.

Dónde se guarda el estado

Todo lo que Dropstone guarda en disco se encuentra en dos directorios.

QuémacOS / LinuxWindows
Credenciales y sesiones~/.local/share/dropstone/%USERPROFILE%\.local\share\dropstone
Registros~/.local/share/dropstone/log/%USERPROFILE%\.local\share\dropstone\log
Caché~/.cache/dropstone/%USERPROFILE%\.cache\dropstone

Dentro del directorio de datos:

  • auth.json — tus credenciales. Elimínalo solo para forzar un inicio de sesión limpio.
  • log/ — registros con marca de tiempo. Se conservan los diez más recientes.
  • project/ — historial de sesiones, limitado por proyecto.

Un archivo de registro se nombra según el momento en que se escribió, por ejemplo 2026-05-23T123456.log. El más reciente es el que necesitas.

Obtén un registro que valga la pena leer

Por defecto, el nivel de registro es silencioso. Dos banderas lo cambian:

# Salida detallada escrita en el archivo de registro
dropstone --log-level DEBUG

# La misma salida transmitida a tu terminal a medida que ocurre
dropstone --print-logs

Usa ambas juntas cuando quieras observar el fallo mientras ocurre y aun así tener el archivo después.

Si el problema es un bloqueo al iniciar, --print-logs es la que ayuda: el archivo de registro puede no escribirse antes de que el proceso muera, pero stderr siempre se escribe.

Qué incluir en un informe

Un informe con estas cinco cosas suele necesitar una sola respuesta para resolverse. Un informe sin ellas suele necesitar cuatro.

  1. El comando exacto que ejecutaste. No una paráfrasis: la línea literal, incluidas las banderas.

  2. Lo que esperabas y lo que ocurrió. Ambas partes. "Falló" no acota nada.

  3. Tu versión y plataforma.

    dropstone --version

    Además de tu sistema operativo y versión, y si estás en Windows nativo o dentro de WSL.

  4. El extracto relevante del registro. Algunas líneas a cada lado del error, no el archivo completo. Redacta cualquier cosa sensible: los registros de sesión pueden contener rutas de archivos y código.

  5. Si es reproducible. Siempre, a veces o una vez. "A veces" vale la pena decirlo; apunta a problemas de sincronización o estado en lugar de una entrada incorrecta.

Envíalo a dropstone.io/contact.

Acotando el problema

Si la causa aún no es evidente, elimina variables una a la vez. Cada una de estas elimina una categoría completa.

¿Es el proyecto? Ejecuta Dropstone en un directorio vacío. Si funciona allí, el problema está limitado al proyecto: probablemente un archivo de configuración, un archivo de reglas o algo en el repositorio que el agente está leyendo.

¿Es tu configuración? Mueve temporalmente dropstone.json a un lado y reinicia. Consulta Configuración para saber dónde viven los archivos de configuración globales y del proyecto.

¿Es un servidor MCP? Un servidor que se cuelga al iniciar puede detener toda la sesión. Lístalos y desactívalos, luego vuelve a activarlos uno a la vez:

dropstone mcp list

¿Es la red? Los proxies corporativos son la causa más común de fallos que parecen otra cosa. Comprueba:

curl -I https://dropstone.io

Si eso falla o devuelve algo inesperado, consulta Red y proxy. La solución habitual es configurar HTTPS_PROXY y, lo más importante, NO_PROXY=localhost,127.0.0.1 — Dropstone usa un bucle local durante las sesiones interactivas, y enrutar eso a través de un proxy causa un bucle.

¿Son tus credenciales? Cierra sesión y vuelve a iniciarla:

dropstone auth logout
dropstone auth login

¿Es la terminal? En Linux, copiar y pegar necesitan una utilidad de portapapeles instalada. Consulta Solución de problemas de CLI.

¿Es Windows? El acceso lento a archivos, los fallos de terminal y los problemas de rutas en Windows nativo suelen desaparecer bajo WSL. Consulta Windows y WSL.

Antes de contactar con el soporte

Relacionado

Ctrl+I