Dropstone Docs

Sesión interactiva

Cómo trabajar dentro de una sesión de Dropstone. Referencias de archivos, escapes de shell, comandos slash e integración de editor.

Dropstone se ejecuta como una sesión interactiva en tu terminal. Cada sesión está vinculada al directorio desde el que la iniciaste, mantiene el historial de conversación y permanece abierta hasta que salgas. Esta página cubre cómo controlar una sesión: cómo referenciar archivos, ejecutar comandos de shell, usar comandos slash e conectar un editor externo.

Iniciar una sesión

Ejecuta dropstone desde dentro de un proyecto:

dropstone

O apúntalo a un directorio específico:

dropstone /path/to/project

Una vez que Dropstone esté activo, escribe cualquier prompt en lenguaje natural:

Give me a quick summary of the codebase.

Referencias de archivos

Referencia archivos en tus mensajes con @. Esto realiza una búsqueda difusa en el directorio de trabajo actual.

How is auth handled in @src/api/index.ts?

El contenido del archivo se añade automáticamente a la conversación, para que el agente pueda leerlo sin necesidad de buscarlo primero.

Comandos de shell

Comienza un mensaje con ! para ejecutar un comando de shell. La salida se añade a la conversación como resultado de herramienta para que el agente pueda reaccionar.

!ls -la
!git diff

Comandos slash

Escribe / seguido del nombre del comando para realizar una acción rápida. La mayoría tienen un atajo de teclado usando ctrl+x como tecla líder (configurable a través de Keybindings).

/help

compact

Compacta la sesión actual. El contexto más antiguo se resume para que el trabajo más nuevo tenga espacio. Alias: /summarize.

Keybind: ctrl+x c

details

Alterna si se muestran los detalles de ejecución de herramientas en línea.

editor

Abre tu editor externo para componer un mensaje más largo. Utiliza el editor configurado en EDITOR. Ver Editor setup.

Keybind: ctrl+x e

effort

Ajusta la profundidad de razonamiento del modelo activo. Abre un selector con cuatro niveles: low, medium, high, xhigh. Un esfuerzo mayor produce un razonamiento más profundo a costa de más créditos y una latencia ligeramente mayor. Alias: /thinking.

exit

Salir de Dropstone. Aliases: /quit, /q.

Keybind: ctrl+x q

export

Exporta la conversación actual a Markdown y ábrela en tu editor (usa EDITOR).

Keybind: ctrl+x x

help

Muestra el diálogo de ayuda con cada comando slash y keybind.

init

Configuración guiada para crear o actualizar AGENTS.md. Ver Rules (AGENTS.md).

models

Lista los modelos disponibles para esta sesión.

Keybind: ctrl+x m

new

Inicia una nueva sesión en el directorio actual. Alias: /clear.

Keybind: ctrl+x n

redo

Rehace un mensaje previamente deshecho. Solo disponible después de /undo. Los cambios de archivo se restauran como parte del redo.

Requires Git:

Undo y redo usan Git para gestionar snapshots de estado de archivo, por lo que tu proyecto debe ser un repositorio Git.

Keybind: ctrl+x r

sessions

Lista y cambia entre sesiones. Aliases: /resume, /continue.

Keybind: ctrl+x l

undo

Deshace el último mensaje en la conversación. Elimina el mensaje de usuario más reciente, todas las respuestas posteriores y cualquier cambio de archivo realizado en esos turnos.

Requires Git:

Undo usa Git para revertir cambios de archivo, por lo que tu proyecto debe ser un repositorio Git.

Keybind: ctrl+x u

upgrade

Abre la página de precios de Dropstone para actualizar tu plan. Úsalo cuando necesites más créditos semanales o acceso a niveles premium (Dropstone Pro, Dropstone Heavy).

Plan upgrade vs CLI upgrade:

/upgrade es la actualización de plan. Para actualizar el binario de Dropstone CLI en sí, ejecuta dropstone update desde tu shell.

usage

Muestra el consumo de créditos de la semana actual, nombre del plan, límite semanal y cuándo se reinician los créditos.

Configuración del editor

Los comandos /editor y /export lanzan el editor en tu variable de entorno EDITOR.

# Terminal editors
export EDITOR=nano
export EDITOR=vim

# GUI editors (VS Code, Cursor, VSCodium, Windsurf, Zed, etc.)
# require --wait so the editor process blocks until closed
export EDITOR="code --wait"

Para hacerlo permanente, añádelo a tu perfil de shell (~/.bashrc, ~/.zshrc, etc.).

Opciones populares:

  • code para Visual Studio Code
  • cursor para Cursor
  • windsurf para Windsurf
  • nvim para Neovim
  • vim para Vim
  • nano para Nano
  • subl para Sublime Text
  • notepad para Windows Notepad

The --wait flag:

Los editores GUI como VS Code regresan inmediatamente por defecto, lo que saltaría tu mensaje. La bandera --wait hace que el proceso del editor se bloquee hasta que cierres el archivo, para que Dropstone pueda leer lo que escribiste.

Personalización

Algunas preferencias a nivel de sesión viven en la paleta de comandos (Ctrl+P). Busca lo que quieras cambiar; la configuración se recuerda entre sesiones.

  • Hide username: elimina tu nombre de usuario de los mensajes de chat
  • Diff style: elige entre adaptive (predeterminado) y single-column stacked diffs
  • Mouse capture: alterna si la terminal maneja la selección del ratón en sí misma, o lo hace Dropstone

Para todo lo demás (keybinds, formateadores, formato de archivo de configuración), ver las páginas dedicadas: Keybindings, Formatters, Configuration.

Privacidad y retención de datos

Tus prompts, código y transcripciones de conversación nunca se utilizan para entrenar modelos y no se retienen más allá de la vida útil de tu sesión. Dropstone utiliza almacenamiento en caché de prompts con alcance de sesión para reducir costos y latencia, de la misma manera que lo hacen Anthropic y OpenAI: el contenido en caché está aislado en tu propia cuenta, expira automáticamente y nunca se reutiliza para ningún otro usuario ni se envía al entrenamiento de modelos.

Estos controles son aplicados y revisados por Blankline, la empresa matriz de Dropstone. El equipo de cumplimiento de Blankline audita el manejo de datos de Dropstone de forma recurrente y retiene autoridad de revocación sobre el acceso de producción de cualquier individuo o sistema que incumpla la política.

Ver la Trust page para la postura completa, incluyendo divulgaciones de subprocesadores y el límite de seguridad en tiempo de ejecución.

Ctrl+I