Referencia de CLI

DROID+ se distribuye como un único binario con un conjunto de subcomandos para gestionar los motores de ejecución de agentes de IA.

droid

DROID+ — Motor de ejecución de agentes de IA sin interfaz (headless). Al igual que nginx sirve sitios web, DROID+ sirve agentes de IA. Un binario, una configuración, agentes listos para producción en minutos.

Uso:

droid [command]

Comandos disponibles:

Comando	Descripción
init	Inicializar un nuevo proyecto de DROID+
up	Iniciar el motor de ejecución de DROID+
down	Detener una instancia de DROID+ en ejecución
agents	Listar los agentes en ejecución
agents reload	Recarga en caliente de las configuraciones de los agentes
health	Comprobar el estado del servidor de DROID+
version	Imprimir información de la versión

Flags globales:

Flag	Descripción
-h, --help	Ayuda para droid

---

droid init

Crear un nuevo directorio con una configuración mínima de DROID+, un agente de ejemplo y una plantilla de .env.

Uso:

droid init [project-name]

Argumentos:

• project-name — Nombre del directorio a crear (por defecto: my-agent)

Ejemplo:

droid init skincare-bot
cd skincare-bot

Archivos creados:

• droid.yaml — Configuración principal
• configs/agents/example.yaml — Configuración del agente de ejemplo
• .env.example — Plantilla de variables de entorno

---

droid up

Iniciar el motor de ejecución de agentes de IA DROID+ con API compatible con OpenAI y API de gestión.

Uso:

droid up [flags]

Flags:

Flag	Tipo	Por defecto	Descripción
--config, -c	string	autodetección	Ruta al archivo de configuración
--daemon, -d	bool	false	Ejecutar en segundo plano (usar systemd/docker para producción)

Ejemplos:

# Iniciar con configuración autodetectada
droid up

# Iniciar con un archivo de configuración específico
droid up --config /etc/droid/droid.yaml

# Iniciar en segundo plano
droid up -d

---

droid down

Enviar SIGTERM al proceso de DROID+ en ejecución utilizando el archivo PID.

Uso:

droid down

Ejemplo:

droid down

---

droid agents

Consultar la API de gestión para listar todos los agentes cargados y su estado.

Uso:

droid agents [flags]

Flags:

Flag	Tipo	Por defecto	Descripción
--port	int	8081	Puerto de la API de gestión

Ejemplo:

# Listar agentes en el puerto por defecto
droid agents

# Listar agentes en un puerto de gestión personalizado
droid agents --port 9091

droid agents reload

Recarga en caliente de las configuraciones de los agentes sin reiniciar el motor de ejecución. Lee el directorio de agentes y aplica cualquier cambio.

Uso:

droid agents reload

Ejemplo:

# Añadir un nuevo YAML de agente, luego recargar
cp new-agent.yaml configs/agents/
droid agents reload

---

droid health

Sondear los endpoints de salud de la API compatible con OpenAI y de la API de gestión.

Uso:

droid health [flags]

Flags:

Flag	Tipo	Por defecto	Descripción
--openai-port	int	8080	Puerto de la API de OpenAI
--management-port	int	8081	Puerto de la API de gestión

Ejemplo:

# Comprobar salud en los puertos por defecto
droid health

# Comprobar salud en puertos personalizados
droid health --openai-port 9080 --management-port 9081

---

droid version

Imprimir información de la versión de DROID+.

Uso:

droid version [flags]

Flags:

Flag	Descripción
--json	Salida en formato JSON

Ejemplo:

droid version
# DROID+ v0.5.0 (community) built ...

droid version --json
# {"version":"0.5.0","edition":"community","commit":"...","build_time":"..."}