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:
codepara Visual Studio Codecursorpara Cursorwindsurfpara Windsurfnvimpara Neovimvimpara Vimnanopara Nanosublpara Sublime Textnotepadpara 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.