Descripción general
Dropstone CLI es una herramienta de codificación agéntica que se ejecuta en tu terminal. Pídele que lea código, ejecute comandos, planifique cambios y edite archivos, todo desde tu shell.
Dropstone es el camino más rápido hacia la codificación agéntica si vives en la terminal. Esta página te permite instalarlo, iniciar sesión y tener tu primera conversación.
Requisitos previos
- Un emulador de terminal moderno. Cualquiera sirve; probamos con WezTerm, Alacritty, Ghostty y Kitty.
- Una cuenta de Dropstone. Regístrate en dropstone.io para usar la línea de modelos integrada (Fast, Pro, Heavy).
Instalación
Homebrew (recomendado):
brew tap blankline-org/dropstone-cli
brew install dropstone
O el script de instalación:
curl -fsSL https://dropstone.io/install | bash
Ambos métodos colocan un único binario dropstone en tu PATH. Sin Node, sin dependencias de runtime.
Verifica la instalación:
dropstone --version
Iniciar sesión
Muévete a cualquier directorio de proyecto y inicia Dropstone:
cd /ruta/a/tu/proyecto
dropstone
En el primer lanzamiento se te pedirá iniciar sesión. Dos opciones:
- Continuar en el navegador (recomendado). Abre dropstone.io/login, te inicia sesión y devuelve el token al CLI automáticamente. Usa PKCE para que el token nunca aparezca en la barra de URL de tu navegador.
- Pegar un token. Para sesiones SSH o sin interfaz gráfica. Obtén un token en dropstone.io/account y pégalo.
Ejecuta /login desde dentro de Dropstone para cambiar de cuenta más tarde.
Elegir un modelo
Dropstone incluye tres niveles de modelo. Los tres están alojados en infraestructura de EE. UU. y ajustados para codificación.
| Nivel | Mejor para |
|---|---|
| Fast | Ediciones rápidas, scaffolding, refactorizaciones de un solo archivo. El nivel predeterminado. |
| Pro | Refactorizaciones de varios archivos, cambios transversales, razonamiento más amplio. |
| Heavy | Decisiones de arquitectura, migraciones grandes, depuración ambigua o intensiva en investigación. |
Cambia de nivel durante una sesión con /effort low, /effort medium, /effort high o /effort xhigh. Ctrl+T los recorre. Consulta Modelos para más información.
Inicializar un proyecto
Dentro de la raíz de un proyecto, ejecuta:
/init
Dropstone escanea la estructura de tu proyecto y crea un archivo AGENTS.md en la raíz del repositorio. Haz commit en git: aquí es donde codificas las convenciones del proyecto, los comandos de compilación y los detalles que Dropstone debe conocer en cada prompt.
Consulta Reglas (AGENTS.md) para conocer el formato completo.
Primera conversación
Estás listo. Haz preguntas, solicita cambios o planifica funciones.
Pregunta sobre el código
¿Cómo se maneja la autenticación en @src/auth/session.ts?
Usa @ para buscar archivos con coincidencia difusa y fijarlos en el prompt.
Planifica antes de construir
Presiona Tab para cambiar al modo Plan. En el modo Plan, Dropstone no puede editar archivos; solo describe lo que haría.
Agrega una columna "deleted_at" a la tabla de notas. Luego crea una pantalla que
liste las notas eliminadas recientemente con botones de restaurar y eliminar permanentemente.
Itera sobre el plan. Cuando estés satisfecho, presiona Tab nuevamente para volver al modo Build y dile que continúe.
Ediciones directas
Para cambios pequeños, omite el plan:
Agrega autenticación a /settings de la misma manera que se maneja en /notes.
Deshacer y rehacer
/undo
/redo
/undo revierte el ciclo de edición anterior y vuelve a mostrar tu prompt para que puedas ajustarlo. Ejecútalo varias veces para retroceder más. /redo reproduce un paso deshecho.
Uso y límites
Escribe /usage para ver tu uso semanal, nivel de plan y cuenta regresiva de reinicio. Escribe /upgrade para abrir la página de precios si necesitas más margen.