Dropstone Docs

Bienvenido a Dropstone

Dropstone es una herramienta de codificación agéntica que vive en tu terminal. Lee tu base de código, realiza ediciones coordinadas entre archivos, ejecuta comandos y explica su razonamiento mientras trabaja.

Dropstone ejecutándose dentro de una terminal

Describes lo que quieres, y Dropstone lee el código relevante, planifica el cambio, edita archivos, ejecuta comandos y explica lo que hizo. Funciona en proyectos reales, no en fragmentos de juguete, y se mantiene anclado en el código que ya tienes.

Esta página te da una idea de la forma del producto. La Guía de inicio rápido te guía a través de la instalación y el envío de tu primer cambio.

Instálalo en segundos

Homebrew (recomendado):

brew tap blankline-org/dropstone-cli
brew install dropstone

O el script de instalación:

curl -fsSL https://dropstone.io/install | bash

Luego entra en cualquier proyecto:

cd /ruta/a/tu/proyecto
dropstone

Verifica la instalación con dropstone --version. En el primer lanzamiento se te pedirá que inicies sesión; los detalles completos del inicio de sesión están en la página de Guía de inicio rápido.

Lo que puedes hacer

Entender una base de código

Pregunta cómo fluye la autenticación a través del sistema, dónde podría esconderse un error, o cómo está conectado un módulo. Dropstone lee archivos bajo demanda y responde con citas al código real.

Crear funciones y corregir errores

Describe el cambio en lenguaje sencillo. Dropstone propone un plan, edita entre archivos y muestra los diffs antes de que nada se aplique.

Ejecutar, probar y verificar

Las comprobaciones de tipos, pruebas y lints se ejecutan automáticamente cuando existen. Los fallos vuelven al plan para que el resultado esté en verde cuando lo leas.

Crear commits y pull requests

Genera mensajes de commit convencionales, empuja ramas y abre PRs a través de la integración con GitHub o GitLab. Resúmenes de revisión de código incluidos.

Conecta tus herramientas con MCP

Conecta bases de datos, APIs internas, sistemas de tickets o cualquier servidor del Model Context Protocol. Dropstone los trata como herramientas de primera clase.

Personaliza con reglas y habilidades

Coloca un AGENTS.md en la raíz del repositorio para enseñar a Dropstone tus convenciones. Empaqueta flujos de trabajo reutilizables como habilidades.

Compón con el shell

Dropstone es un ciudadano de Unix. La sesión interactiva es la superficie predeterminada, pero cada capacidad está disponible desde una invocación de una sola vez, lo que lo hace programable en CI, hooks de pre-commit y tus propios flujos de trabajo.

# De una sola vez: haz una pregunta y sal
dropstone run "Explica cómo funciona el middleware de autenticación"

# Envía un archivo
dropstone run "Encuentra problemas de seguridad" < src/auth.ts

# Úsalo en un pipeline de shell
git diff main | dropstone run "Escribe una descripción de PR para este diff"

# Condúcelo desde CI sin un TTY
dropstone run --json "Genera notas de versión a partir de los últimos 20 commits"

Cómo funciona

Dropstone se ejecuta como un único binario en tu terminal. Nada que configurar, sin runtime que instalar: lo inicias dentro de un proyecto y opera sobre los archivos en tu directorio de trabajo. Si prefieres tenerlo junto a tu código como un panel, también existe Dropstone para VS Code.

Cada turno sigue el mismo bucle:

1

Describes la tarea en lenguaje sencillo

Sin sintaxis especial. "Añade un endpoint /healthz que devuelva información de compilación" es suficiente.

2

Dropstone reúne contexto

Lee archivos, busca símbolos e inspecciona la estructura hasta que tiene suficiente para actuar.

3

Propone y ejecuta un plan

Las ediciones se muestran como diffs. Los comandos de shell piden permiso a menos que los hayas incluido en la lista blanca.

4

Verifica el resultado

Las comprobaciones de tipos, pruebas y lints se ejecutan automáticamente cuando existen. Los fallos vuelven al plan.

Toda la interacción permanece en tu terminal. Tu código nunca se envía a ningún lugar excepto a la inferencia propia de Dropstone, que se opera bajo una política de no retención y no entrenamiento. Consulta la página de Confianza para más detalles.

Usa Dropstone en todas partes

Quiero…Mejor opción
Iniciar una sesión de codificación interactivaEjecuta dropstone en el directorio de tu proyecto
Hacer una pregunta puntual sin sesióndropstone run "..." o envía un archivo con <
Reanudar la última sesióndropstone --continue (o dropstone -c)
Conectar una herramienta personalizada o API internaServidores MCP
Enseñar a Dropstone las convenciones de tu repositorioColoca un AGENTS.md en la raíz del repositorio
Empaquetar un flujo de trabajo reutilizableHabilidades y Plugins
Usar Dropstone en CI o pre-commitdropstone run con --json y el modelo de permisos
Elegir el nivel de modelo adecuado para la tareaModelos (Fast / Pro / Heavy)
Ejecutar dentro de un sandbox o shell restringidoPermisos

Construido en torno a tres niveles de modelo

Eliges el modelo que se adapta al trabajo. Los tres están alojados en infraestructura de EE. UU. y ajustados para la codificación.

Fast

Dropstone Fast

Ediciones rápidas, scaffolding, refactorizaciones de un solo archivo y depuración conversacional. Primer token en menos de un segundo. El nivel predeterminado para nuevas sesiones.
ProRecomendado

Dropstone Pro

Refactorizaciones de varios archivos, cambios transversales y tareas que necesitan un razonamiento más amplio. Cambia con /effort high.
Heavy

Dropstone Heavy

Decisiones de arquitectura, migraciones grandes y depuración difícil. El razonamiento más profundo y el mayor presupuesto de pensamiento. Cambia con /effort xhigh.

Consejo:

No necesitas pensar en la selección del modelo de antemano. Comienza en Fast y usa /effort desde dentro de Dropstone para subir de nivel cuando una tarea necesite más profundidad.

Dónde ir a continuación

1

Ponte en marcha

La Guía de inicio rápido cubre la instalación, el inicio de sesión y tu primera tarea.

2

Elige un nivel de modelo

Modelos profundiza en Fast, Pro y Heavy, y cuándo recurrir a cada uno.

3

Configura a tu gusto

Configuración cubre los ajustes globales y por proyecto; Permisos y Atajos de teclado cubren el resto.

4

Mira lo nuevo

El Registro de cambios enumera cada versión con los cambios visibles para el usuario.

Una vez que estés configurado, la referencia de CLI y la guía de comandos de barra son las dos páginas a las que volverás con más frecuencia.


¿Estás construyendo un agente o una aplicación LLM que necesite leer estos documentos? Apúntalo a /llms.txt para un índice del sitio, o a /llms-full.txt para el corpus completo en un solo archivo.

Ctrl+I