Inicio rápido

Instala Dropstone, inicia sesión y envía tu primer cambio en menos de cinco minutos. Esta guía te lleva de cero a un bucle de agente funcional.

Al final de esta guía tendrás Dropstone instalado, con sesión iniciada y produciendo ediciones reales en un proyecto de tu elección.

Antes de comenzar

Necesitas:

Una terminal o símbolo del sistema
Un proyecto en disco al que apuntar Dropstone (cualquier lenguaje, cualquier tamaño)
Una cuenta de Dropstone, que puedes crear en dropstone.io

Paso 1: Instalar Dropstone

Elige la ruta de instalación para tu plataforma.

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 instalan un único binario dropstone en tu PATH. Sin Node, sin dependencias de runtime.

Verifica la instalación:

dropstone --version

Deberías ver un número de versión (la versión actual es 1.0.8). El binario se actualiza automáticamente en segundo plano, por lo que te mantienes al día sin volver a ejecutar el instalador.

Paso 2: 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.

Tus credenciales se almacenan en disco después del primer inicio de sesión. Para cambiar de cuenta más tarde, ejecuta /login desde Dropstone.

Paso 3: Inicia tu primera sesión

Ahora estás viendo la pantalla de inicio de Dropstone. Tres cosas a tener en cuenta:

Tu nivel de modelo actual se muestra en la parte superior derecha (predeterminado: Dropstone Fast)
El cuadro de entrada en la parte inferior es donde escribes
Los comandos de barra comienzan con /. Prueba /help para verlos todos

Escribe cualquier indicación en lenguaje natural para iniciar una sesión. No hay sintaxis especial que aprender.

Paso 4: Haz tu primera pregunta

Deja que Dropstone recorra el proyecto por ti. Prueba una de estas:

¿qué hace este proyecto?

¿cuáles son los puntos de entrada principales?

explica la estructura de carpetas

Dropstone leerá archivos bajo demanda y responderá con citas al código real. No necesitas pegar archivos ni escribir contexto manualmente.

También puedes preguntarle a Dropstone sobre sí mismo:

¿qué puedes hacer en este proyecto?

¿qué comandos tienes permiso para ejecutar?

Paso 5: Haz tu primer cambio de código

Ahora describe un cambio pequeño. Para un proyecto nuevo, prueba algo de bajo riesgo:

añade un README con una descripción del proyecto de un párrafo

Para un proyecto existente:

añade validación de entrada a la función que crea un usuario

Dropstone hará lo siguiente:

Encontrará el archivo relevante
Mostrará el cambio propuesto como un diff
Pedirá tu aprobación antes de escribir
Verificará el resultado (comprobaciones de tipos, pruebas, lints si están disponibles)

Permisos:

Dropstone pide aprobación la primera vez que quiere editar un archivo o ejecutar un comando de shell. Aprueba una vez, y la misma operación en la misma sesión se ejecutará sin volver a preguntar. Usa /permissions para ver o revocar lo que has permitido.

Paso 6: Trabaja con git

Dropstone trata a git como una herramienta de primera clase:

¿qué archivos he cambiado?

haz commit de mis cambios con un mensaje descriptivo

crea una rama llamada feature/health-endpoint y cambia a ella

muestra los últimos cinco commits

ayúdame a resolver el conflicto de fusión en src/auth.ts

Para flujos de trabajo a nivel de PR (abrir pull requests, generar descripciones de PR, publicar comentarios de revisión), consulta Integración con GitHub.

Paso 7: Corrige un error o añade una función

Describe lo que quieres en lenguaje sencillo. Dropstone localizará el código, entenderá el contexto, implementará el cambio y lo verificará.

hay un error donde las consultas de búsqueda vacías devuelven todos los resultados - arréglalo

añade un endpoint /healthz al servidor de API que devuelva información de compilación

el formulario de inicio de sesión falla cuando falta el correo electrónico - averigua por qué y arréglalo

Si la tarea abarca varios archivos, Dropstone escribirá un plan breve y lo ejecutará paso a paso. Puedes presionar Esc en cualquier momento para interrumpir y dirigir.

Paso 8: Prueba otros flujos de trabajo comunes

Algunos patrones en los que Dropstone es bueno:

Refactorización

refactoriza el módulo de autenticación para usar async/await en lugar de callbacks

Escribir pruebas

escribe pruebas unitarias para las funciones de la calculadora

Revisión de código

revisa mis cambios en staging y señala cualquier cosa arriesgada

Documentación

actualiza las instrucciones de instalación del README para incluir la ruta de WSL

Consejo:

Habla con Dropstone como con un compañero de equipo. Describe lo que quieres lograr, no los pasos exactos para llegar allí. El agente es mejor planificando cuando le dejas las decisiones de implementación a él.

Comandos esenciales

Los pocos comandos que realmente usarás:

Comando	Qué hace	Ejemplo
`dropstone`	Inicia una sesión interactiva en el directorio actual	`dropstone`
`dropstone run "tarea"`	Ejecuta una tarea única y sale	`dropstone run "explica auth.ts"`
`dropstone -c`	Continúa la última sesión en este directorio	`dropstone -c`
`dropstone --session ID`	Reanuda una sesión específica por id	`dropstone --session 7f3a...`
`/help`	Muestra todos los comandos de barra	dentro de una sesión
`/effort`	Cambia el nivel de modelo para esta sesión	`/effort high`
`/clear`	Borra la conversación actual	dentro de una sesión
`/login`	Cambia de cuenta	dentro de una sesión
`exit` o `Ctrl+D`	Sale de Dropstone

La referencia completa está en las páginas de CLI y comandos de barra.

Consejos profesionales para nuevos usuarios

Qué sigue

Referencia del CLI

Cada bandera, cada subcomando, cada opción. La página que marcas como favorita.

Comandos de barra

Cada comando de barra en un solo lugar. Útil después de una semana de uso.

Enseña a Dropstone tu repositorio (AGENTS.md)

Coloca un archivo en la raíz del repositorio que le diga a Dropstone tus convenciones, comandos de compilación y problemas comunes.

Conecta tus propias herramientas (MCP)

Integra bases de datos, APIs internas, sistemas de tickets o cualquier cosa que hable el Model Context Protocol.

Modelos y proveedores

Más sobre Fast 1.6, Pro 1.6 y Heavy 1.6, además de cómo establecer un predeterminado en tu configuración.

Permisos

Controla exactamente qué puede leer, escribir y ejecutar Dropstone en tus proyectos.

Obtener ayuda

Dentro de Dropstone, escribe /help o pregunta en lenguaje sencillo ("¿cómo cambio de modelo?")
Explora el resto de la documentación en docs.dropstone.io
Reporta un problema o solicita una función en dropstone.io/contact

Overview

Pricing