Files
agents_and_robots/dev-scripts/README.md
egutierrez 6858a5f13e refactor: reorganizar dev-scripts en subdirectorios server/ y agent/
Se separan los scripts de gestión en dos categorías claras:
- dev-scripts/server/ — operaciones del launcher (start, stop, restart, ps, logs, dashboard)
- dev-scripts/agent/ — operaciones de agentes (new, register, verify, avatar, remove, list)

Se añade create-full.sh como script unificado que ejecuta scaffold + build + register + verify.
Se incluyen READMEs en cada subdirectorio documentando los scripts disponibles.
Los scripts originales en la raíz de dev-scripts/ se eliminan.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-03-06 21:53:19 +00:00

1.7 KiB

dev-scripts

Scripts bash para operaciones del día a día con los bots Matrix.

Todos los scripts comparten funciones comunes definidas en _common.sh (colores, helpers de proceso, descubrimiento de agentes, carga de .env).

Estructura

dev-scripts/
├── _common.sh       funciones compartidas (sourced por todos los scripts)
├── server/          gestión del launcher (ciclo de vida del servidor)
└── agent/           gestión de agentes individuales (setup, registro, E2EE)

server/

Scripts para controlar el launcher unificado que ejecuta todos los agentes.

Script Descripción
start.sh Inicia el launcher (compila si es necesario)
stop.sh Detiene el launcher (SIGTERM, espera 5s, SIGKILL)
restart.sh Reinicia el launcher (stop + start)
ps.sh Muestra el proceso del launcher con detalle (PID, mem, CPU, uptime)
logs.sh [lines] Tail -f de los logs del launcher
dashboard.sh Abre la TUI interactiva de gestión
server.sh <cmd> CLI unificado que enruta a los scripts anteriores

agent/

Scripts para crear, registrar, verificar y gestionar agentes individuales.

Script Descripción
new-agent.sh <id> [name] Genera scaffold completo (config, agent.go, prompts)
register.sh <id> [name] Registra bot en Matrix via Synapse admin API
verify.sh [id] Verifica/regenera dispositivos E2EE (cross-signing)
avatar.sh <id> <img> Sube avatar y sincroniza displayname
reset-password.sh <id> Resetea password sin invalidar el token
remove.sh <id> Deshabilita un agente (enabled: false, no borra datos)
list.sh Muestra todos los agentes y su estado