CLI

Opciones y comandos de Dropstone CLI.

La CLI de Dropstone inicia por defecto una sesión interactiva cuando se ejecuta sin argumentos.

dropstone

Pero también acepta comandos como se documenta en esta página. Esto te permite interactuar con Dropstone de forma programática.

dropstone run "Explain how closures work in JavaScript"

tui

Inicia una sesión interactiva de Dropstone. Este es el comportamiento predeterminado cuando ejecutas dropstone sin subcomando; dropstone tui es la forma explícita.

dropstone [project]

Banderas

Flag	Short	Descripción
	`-c`	Continuar la última sesión
	`-s`	ID de sesión para continuar
		Bifurcar la sesión al continuar (usar con `--continue` o `--session`)
		Prompt a utilizar
	`-m`	Modelo a utilizar (`dropstone/dropstone-fast`, `dropstone/dropstone-pro`, o `dropstone/dropstone-heavy`)
		Agente a utilizar
		Puerto en el que escuchar
		Nombre de host en el que escuchar
		Habilitar descubrimiento mDNS
		Nombre de dominio mDNS personalizado
		Origen(es) de navegador adicional(es) para permitir CORS

Comandos

La CLI de Dropstone también tiene los siguientes comandos.

agent

Gestionar agentes para Dropstone.

dropstone agent [command]

create

Crear un nuevo agente con configuración personalizada.

dropstone agent create

Este comando te guiará a través de la creación de un nuevo agente con un prompt de sistema personalizado y configuración de permisos. Cualquier cosa que no permitas será denegada en el frontmatter del agente generado.

Banderas

Flag	Short	Descripción
		Directorio donde escribir el archivo del agente (por defecto global o `.dropstone/agent` según el prompt)
		Qué debe hacer el agente
		Modo del agente: `all`, `primary`, o `subagent`
		Lista separada por comas de permisos a permitir (por defecto: todos). Disponibles: `bash`, `read`, `edit`, `glob`, `grep`, `webfetch`, `task`, `todowrite`, `websearch`, `lsp`, `skill`. Cualquier cosa omitida es denegada. Alias: `--tools`
	`-m`	Modelo a utilizar (`dropstone/dropstone-fast`, `dropstone/dropstone-pro`, o `dropstone/dropstone-heavy`)

Pasar todos los --path, --description, --mode, y --permissions ejecuta el comando de forma no interactiva.

list

Listar todos los agentes disponibles.

dropstone agent list

attach

Adjuntar una terminal a un servidor backend de Dropstone ya en ejecución iniciado mediante los comandos serve o web.

dropstone attach [url]

Esto te permite apuntar una sesión interactiva a un servidor de Dropstone que se ejecuta en otra máquina. Por ejemplo:

# En la máquina host, inicia el servidor
dropstone web --port 4096 --hostname 0.0.0.0

# En otra máquina, adjunta una sesión a él
dropstone attach http://10.20.30.40:4096

Banderas

Flag	Short	Descripción
		Directorio de trabajo para iniciar la sesión
	`-c`	Continuar la última sesión
	`-s`	ID de sesión para continuar
		Bifurcar la sesión al continuar (usar con `--continue` o `--session`)
	`-p`	Contraseña de autenticación básica (por defecto `DROPSTONE_SERVER_PASSWORD`)
	`-u`	Nombre de usuario de autenticación básica (por defecto `DROPSTONE_SERVER_USERNAME` o `dropstone`)

auth

Comando para gestionar credenciales e inicio de sesión para proveedores.

dropstone auth [command]

Usa dropstone auth login para iniciar sesión en Dropstone. Tus credenciales se almacenan en ~/.local/share/dropstone/auth.json.

dropstone auth login

Dropstone lee las credenciales de este archivo en cada inicio.

Banderas

Flag	Short	Descripción
	`-p`	ID o nombre del proveedor para iniciar sesión
	`-m`	Etiqueta del método de inicio de sesión a usar, omitiendo la selección de método

list

Lista todos los proveedores autenticados almacenados en el archivo de credenciales.

dropstone auth list

O la versión corta.

dropstone auth ls

logout

Cierra la sesión de un proveedor eliminándolo del archivo de credenciales.

dropstone auth logout

github

Gestionar el agente de GitHub para automatización de repositorios.

dropstone github [command]

install

Instalar el agente de GitHub en tu repositorio.

dropstone github install

Esto configura el flujo de trabajo de GitHub Actions necesario y te guía a través del proceso de configuración. Aprende más.

run

Ejecutar el agente de GitHub. Esto se usa típicamente en GitHub Actions.

dropstone github run

Banderas

Flag	Descripción
	Evento simulado de GitHub para ejecutar el agente
	Token de acceso personal de GitHub

mcp

Gestionar servidores del Protocolo de Contexto de Modelo.

dropstone mcp [command]

add

Añadir un servidor MCP a tu configuración.

dropstone mcp add

Este comando te guiará a través de la adición de un servidor MCP local o remoto.

list

Listar todos los servidores MCP configurados y su estado de conexión.

dropstone mcp list

O usa la versión corta.

dropstone mcp ls

auth

Autenticarse con un servidor MCP habilitado para OAuth.

dropstone mcp auth [name]

Si no proporcionas un nombre de servidor, se te pedirá que selecciones entre los servidores disponibles con capacidad OAuth.

También puedes listar los servidores con capacidad OAuth y su estado de autenticación.

dropstone mcp auth list

O usa la versión corta.

dropstone mcp auth ls

logout

Eliminar credenciales OAuth para un servidor MCP.

dropstone mcp logout [name]

debug

Depurar problemas de conexión OAuth para un servidor MCP.

dropstone mcp debug <name>

models

Listar los niveles de modelo de Dropstone disponibles para tu cuenta.

dropstone models

La salida está en formato dropstone/<nivel>. Dropstone incluye tres niveles:

ID de modelo	Nivel	Mejor para
`dropstone/dropstone-fast`	Fast	Conductor diario predeterminado. Ediciones rápidas, scaffolding, depuración conversacional.
`dropstone/dropstone-pro`	Pro	Refactorizaciones de múltiples archivos, cambios transversales, razonamiento más amplio.
`dropstone/dropstone-heavy`	Heavy	Decisiones de arquitectura, migraciones grandes, depuración difícil.

Consulta Modelos para el desglose completo y cómo establecer un predeterminado.

Banderas

Flag	Descripción
	Actualizar la lista de modelos en caché
	Incluir metadatos (ventana de contexto, capacidades)

run

Ejecutar dropstone en modo no interactivo pasando un prompt directamente.

dropstone run [message..]

Esto es útil para scripting, automatización, o cuando quieres una respuesta rápida sin abrir una sesión interactiva. Por ejemplo:

dropstone run Explain the use of context in Go

También puedes adjuntarte a una instancia de dropstone serve en ejecución para evitar los tiempos de arranque en frío del servidor MCP en cada ejecución:

# Inicia un servidor headless en una terminal
dropstone serve

# En otra terminal, ejecuta comandos que se adjuntan a él
dropstone run --attach http://localhost:4096 "Explain async/await in JavaScript"

Banderas

Flag	Short	Descripción
		El comando a ejecutar, usa mensaje para argumentos
	`-c`	Continuar la última sesión
	`-s`	ID de sesión para continuar
		Bifurcar la sesión al continuar (usar con `--continue` o `--session`)
		Compartir la sesión
	`-m`	Modelo a utilizar (`dropstone/dropstone-fast`, `dropstone/dropstone-pro`, o `dropstone/dropstone-heavy`)
		Agente a utilizar
	`-f`	Archivo(s) para adjuntar al mensaje
		Formato: default (formateado) o json (eventos JSON crudos)
		Título para la sesión (usa el prompt truncado si no se proporciona valor)
		Adjuntar a un servidor dropstone en ejecución (p. ej., http://localhost:4096)
	`-p`	Contraseña de autenticación básica (por defecto `DROPSTONE_SERVER_PASSWORD`)
	`-u`	Nombre de usuario de autenticación básica (por defecto `DROPSTONE_SERVER_USERNAME` o `dropstone`)
		Directorio para ejecutar, o ruta en el servidor remoto al adjuntar
		Puerto para el servidor local (por defecto puerto aleatorio)
		Variante del modelo (esfuerzo de razonamiento específico del proveedor)
		Mostrar bloques de pensamiento
		Aprobar automáticamente permisos que no están explícitamente denegados (¡peligroso!)

serve

Iniciar un servidor Dropstone headless para acceso API. Consulta la documentación del servidor para la interfaz HTTP completa.

dropstone serve

Esto inicia un servidor HTTP headless que proporciona acceso programático a Dropstone, sin abrir una sesión interactiva. Establece DROPSTONE_SERVER_PASSWORD para habilitar la autenticación básica HTTP (el nombre de usuario por defecto es dropstone).

Banderas

Flag	Descripción
	Puerto en el que escuchar
	Nombre de host en el que escuchar
	Habilitar descubrimiento mDNS
	Nombre de dominio mDNS personalizado
	Origen(es) de navegador adicional(es) para permitir CORS

session

Gestionar sesiones de Dropstone.

dropstone session [command]

list

Listar todas las sesiones de Dropstone.

dropstone session list

Banderas

Flag	Short	Descripción
	`-n`	Limitar a N sesiones más recientes
		Formato de salida: table o json (table)

delete

Eliminar una sesión de Dropstone.

dropstone session delete <sessionID>

stats

Mostrar estadísticas de uso de tokens y costos para tus sesiones de Dropstone.

dropstone stats

Banderas

Flag	Descripción
	Mostrar estadísticas de los últimos N días (todo el tiempo)
	Número de herramientas a mostrar (todas)
	Mostrar desglose de uso de modelos (oculto por defecto). Pasa un número para mostrar los N principales
	Filtrar por proyecto (todos los proyectos, cadena vacía: proyecto actual)

export

Exportar datos de sesión como JSON.

dropstone export [sessionID]

Si no proporcionas un ID de sesión, se te pedirá que selecciones entre las sesiones disponibles.

Banderas

Flag	Descripción
	Redactar datos sensibles de transcripción/archivos

import

Importar datos de sesión desde un archivo JSON o URL de compartir de Dropstone.

dropstone import <file>

Puedes importar desde un archivo local o una URL de compartir de Dropstone.

dropstone import session.json
dropstone import https://dropstone.io/s/abc123

web

Iniciar un servidor Dropstone headless con una interfaz web.

dropstone web

Esto inicia un servidor HTTP y abre un navegador web para acceder a Dropstone a través de una interfaz web. Establece DROPSTONE_SERVER_PASSWORD para habilitar la autenticación básica HTTP (el nombre de usuario por defecto es dropstone).

Banderas

Flag	Descripción
	Puerto en el que escuchar
	Nombre de host en el que escuchar
	Habilitar descubrimiento mDNS
	Nombre de dominio mDNS personalizado
	Origen(es) de navegador adicional(es) para permitir CORS

acp

Iniciar un servidor ACP (Protocolo de Cliente de Agente).

dropstone acp

Este comando inicia un servidor ACP que se comunica a través de stdin/stdout usando nd-JSON.

Banderas

Flag	Descripción
	Directorio de trabajo
	Puerto en el que escuchar
	Nombre de host en el que escuchar
	Habilitar descubrimiento mDNS
	Nombre de dominio mDNS personalizado
	Origen(es) de navegador adicional(es) para permitir CORS

plugin

Instalar un plugin y actualizar tu configuración.

dropstone plugin <module>

O usa el alias.

dropstone plug <module>

Banderas

Flag	Short	Descripción
	`-g`	Instalar en configuración global
	`-f`	Reemplazar versión existente del plugin

pr

Obtener y hacer checkout de una rama de PR de GitHub, luego ejecutar Dropstone.

dropstone pr <number>

db

Herramientas de base de datos.

dropstone db [query]

Banderas

Flag	Descripción
	Formato de salida: `json` o `tsv`

path

Imprimir la ruta de la base de datos.

dropstone db path

debug

Herramientas de depuración y resolución de problemas.

dropstone debug [command]

uninstall

Desinstalar Dropstone y eliminar todos los archivos relacionados.

dropstone uninstall

Banderas

Flag	Short	Descripción
	`-c`	Conservar archivos de configuración
	`-d`	Conservar datos de sesión y capturas
		Mostrar qué se eliminaría sin eliminar
	`-f`	Omitir prompts de confirmación

upgrade

Actualiza la CLI de Dropstone a la última versión o a una versión específica. dropstone update es un alias y se comporta de manera idéntica.

dropstone upgrade [target]
# o
dropstone update [target]

Para actualizar a la última versión:

dropstone upgrade

Para instalar una versión específica:

dropstone upgrade 1.0.5

En Windows, si Dropstone está actualmente en ejecución, el instalador prepara la nueva compilación como dropstone.exe.pending. La nueva versión se activa automáticamente en el próximo inicio: no se requieren movimientos manuales de archivos.

Banderas

Flag	Short	Descripción
	`-m`	El método de instalación a usar: `curl`, `npm`, `pnpm`, `bun`, `brew`, `scoop`, `choco`

Banderas Globales

La CLI de dropstone acepta las siguientes banderas globales.

Flag	Short	Descripción
	`-h`	Mostrar ayuda
	`-v`	Imprimir número de versión
		Imprimir registros en stderr
		Nivel de registro (DEBUG, INFO, WARN, ERROR)
		Ejecutar sin plugins externos

Variables de entorno

Dropstone lee las siguientes variables de entorno al iniciar. Estas son las variables orientadas al usuario compatibles; cualquier cosa no listada aquí es interna y puede cambiar o eliminarse sin previo aviso.

Variable	Tipo	Descripción
`DROPSTONE_API_KEY`	string	Clave API de Dropstone para uso headless / CI (omite el inicio de sesión en el navegador)
`DROPSTONE_CONFIG`	string	Ruta a un archivo de configuración `dropstone.json`
`DROPSTONE_TUI_CONFIG`	string	Ruta a un archivo de configuración de sesión (`tui.json`)
`DROPSTONE_DISABLE_AUTOUPDATE`	boolean	Deshabilitar comprobaciones automáticas de actualización de la CLI
`DROPSTONE_GIT_BASH_PATH`	string	Ruta a Git Bash en Windows (usado como herramienta de shell)
`DROPSTONE_SERVER_PASSWORD`	string	Habilitar autenticación básica HTTP en `dropstone serve` / `dropstone web`
`DROPSTONE_SERVER_USERNAME`	string	Sobrescribir el nombre de usuario de autenticación básica (por defecto `dropstone`)

Core concepts

Interactive session

CLI

tui

Banderas

Comandos

agent

create

Banderas

list

attach

Banderas

auth

login

Banderas

list

logout

github

install

run

Banderas

mcp

add

list

auth

logout

debug

models

Banderas

run

Banderas

serve

Banderas

session

list

Banderas

delete

stats

Banderas

export

Banderas

import

web

Banderas

acp

Banderas

plugin

Banderas

pr

db

Banderas

path

debug

uninstall

Banderas

upgrade

Banderas

Banderas Globales

Variables de entorno

En esta página