Son cajas negras — no sabes qué hacen ni qué archivos tocan.
→
📡
Trazabilidad total
Cada run, diff, log y decisión queda registrado, con streaming SSE en vivo.
v0.4 · 18 agentes persistentes · coste de inferencia $0 →
Gobierna una flota de agentes que mantiene tus proyectos.
Regenta no resuelve una tarea suelta: mantiene proyectos enteros vivos. Asignas objetivos, defines alcances y una flota —que tú diseñas— los lleva de la idea al código revisado, con control total.
No es magia. Es control.
› CEO crea proyecto "checkout v2"
◎ Coordinator asigna · ciclo 10s
🔍 Scout analiza repo (read-only) ✓
🏛 Directors planifican · allowedFiles ✓
✋ Aprobación CEO aprobado
🔨 Builder ejecuta · batch cap 3 · file-locks
✅ Reviewer + QA diff auditado ✓
› done — cada run, diff y decisión registrado.
18
agentes persistentes
1570+
tests passing
8
providers LLM
0
coste de inferencia
Por qué existe
Los agentes de IA son potentes. Pero sin control, son un riesgo.
Cada problema clásico de los agentes autónomos tiene una respuesta de ingeniería en Regenta.
Uno descontrolado puede borrar código o filtrar secretos.
→
🛡️
Control Plane
RBAC, file-locks, jaula de workspace y blocklist de comandos peligrosos.
Coordinar varios es caótico — se pisan los archivos.
→
🎯
Coordinator autónomo
Desbloqueo de dependencias, locks exclusivos y retry automático.
No entienden tu proyecto entre sesiones.
→
🧠
Cerebros persistentes
Memoria por agente (brain v3, TF-IDF) que recuerda el contexto entre runs.
Quieres delegar sin perder el control.
→
✋
Human-in-the-loop
Aprobación manual del CEO en cada fase crítica. Los deploys nunca son automáticos.
La inferencia cuesta dinero y escala mal.
→
💸
Inferencia local
Modelos locales vía llama.cpp bajo demanda → coste $0, sin enviar tu código fuera.
Casos de uso
Mantén proyectos vivos, no scripts de una vez.
Le das objetivos y Regenta mantiene un backlog, reparte el trabajo entre la flota y lleva cada tarea de la idea al código revisado. Algunos de sus usos:
🚀
Construir features
Del objetivo en lenguaje natural al código: el scout analiza, el builder implementa bajo scope y el reviewer + QA validan.
♻️
Refactors con red de seguridad
allowedFiles acota el cambio, cada diff queda auditado y el reviewer comprueba los criterios de aceptación.
🧪
Tests y QA
El skill test-runner ejecuta la suite y captura fallos; el rol QA valida cobertura antes de aceptar.
🔍
Code review continuo
El reviewer analiza diffs en busca de bugs, problemas de seguridad y criterios — con tu aprobación final.
📦
Migraciones y bumps de deps
El scout evalúa el estado, se genera un plan por pasos, el builder ejecuta acotado y el reviewer valida.
🐛
Fix de bugs y mantenimiento
El scout localiza, el Coordinator asigna, el builder corrige y el reviewer aprueba — en bucle mientras el proyecto viva.
…y cualquier otra: si puedes describir la tarea y darle alcance, hay un agente para ello.
Capacidades
Una sala de mando, no un chatbot.
Todo lo que necesitas para operar una flota de IA en producción, con disciplina de ingeniería.
🛰️
Coordinator autónomo
Supervisa el fleet completo en un ciclo de 10 s: desbloquea dependencias, reintenta, escala y dispara auto-reviews.
🗂️
Fleet & cadena de mando
18 agentes en un organigrama de 4 niveles —orquestadores, scouts, builders y revisores— con identidad y cerebro propios.
🔄
Pipeline de 7 fases
De un objetivo en lenguaje natural a código revisado: scout → plan → aprobación → build → review → QA → done.
🧠
Cerebros persistentes
Grafo de memoria estilo Obsidian con búsqueda TF-IDF. Cada agente recuerda decisiones y contexto entre runs.
🔀
Router multi-provider
Despacha por agente entre 8 providers (Anthropic, OpenAI, Groq, Gemini…) con failover, cuarentena y backoff 429.
💬
Chat Fleet en vivo
Canales por proyecto, DMs CEO↔agente con memoria, grupos multi-agente y comandos (/task, /approve).
Personalización total
Un agente para lo que sea.
No te quedas con la flota por defecto. Defines tus propios agentes —nombre, rol, persona, modelo y skills— y los colocas en tu cadena de mando.
🎭
Persona e instrucciones propias
Dale a cada agente su system prompt, personalidad, avatar y mascota. Su carácter, sus reglas.
🔀
Modelo y provider por agente
Asigna a cada uno su modelo y sus API keys entre 8 providers — o inferencia local a coste $0.
🧩
Rol y skills a medida
Scout, builder, reviewer u orquestador, con los skills (análisis, build, review, tests, git) que necesites.
🌳
Tu organigrama
Encadena agentes en jerarquía: directores que planifican, especialistas que ejecutan. Tú al mando.
🛰️
Atlas
builder · especialista
nuevo agente
Modeloclaude-opus-4-8 · local
PersonaConciso · TDD-first · explica diffs
Scope
src/api/**
Skills
safe-buildertest-runnergit-pr
Arquitectura
Cinco capas. Separación estricta.
La UI nunca habla con el motor: todo pasa por la API. Cada capa tiene un contrato claro.
🖥️ Presentación
Desktop App · React 18 + Vite + Tailwind 4 — Fleet · Proyectos · Métricas · Cerebros · Ajustes
fetch + SSE
🔌 API Gateway · Express + TS · :3000
🔐 JWT 4h · Helmet · rate-limit 500/min
📡 SSE — task · lock · run · review · audit
📂 REST — projects · tasks · runs · agents · chat
🧠 Core Engine
🎯 Coordinator · ciclo 10s
📝 Task Engine
🤖 Agent Runtime (in-process)
🔀 LLM Router · 8 providers
🛡️ Control Plane
🔒 RBAC + Policies
🔐 File Locks (TTL)
✅ Human Review
📜 Audit Trail
🗝️ Secret Vault · AES-256-GCM
💾 Infraestructura
SQLite (better-sqlite3)
📁 Workspace bajo path-guard
La consola
Diseño neón oscuro. Información densa, no ruido.
Organigrama vivo, Kanban con pipeline de 7 fases y un dashboard de salud — todo en tiempo real por SSE.
La flota
Una cadena de mando, de verdad.
Tú das el proyecto. Los directores planifican. Los especialistas ejecutan. El Coordinator supervisa.
👤 CEOTú · human-in-the-loop
🎯 Coordinatorsupervisa el fleet · ciclo 10s
🏛 CTOTech
🏛 COOOperations
🏛 CPOProduct
🧭 LeadsScout · Builder · Reviewer · Backend · Frontend · AI/ML · QA · Infra · UX
🧑💻 SpecialistsAlpha · Beta
Control Plane
Seguridad por diseño.
Delegar no significa perder el mando. Cada acción pasa por la guardia.
🔒
RBAC + Policies
Permisos granulares por rol: orchestrator, scout, builder, reviewer.
🎯Scope
Scope allowedFiles
Cada tarea declara qué archivos puede tocar; el builder no se sale.
🔐
File Locks (TTL)
Adquisición exclusiva por tarea con expiración automática.
🧱
Path-guard
Jaula de workspace que resuelve symlinks con realpath, no solo léxico.
🚫
Terminal blocklist
Bloquea deploy/publish/login y prompts interactivos.
🗝️
Secret Vault
AES-256-GCM, IV por fila, master key fuera del repo (modo 0600).
📜
Audit Trail
Registro inmutable de cada acción, con stream SSE en /api/audit/stream.
🧯
Anti-loop + quarantine
Skip de tareas con 3+ fallos; keys con error aisladas sin reintentos en bucle.
🔐 Auth: JWT con expiración de 4h, bcrypt (cost 12), queries parametrizadas y rate-limiting. En producción la API exige JWT_SECRET — sin fallback inseguro.
Stack
Construido con herramientas serias.
Monorepo npm workspaces · 13 paquetes @regenta/* + la app desktop.
React 18TypeScriptVite
Tailwind CSS 4TanStack QueryExpress
JWTSSEHelmet
SQLite · better-sqlite3VitestPlaywright
Dockerllama.cppAES-256-GCM
Quick start
De clone a flota corriendo en minutos.
API + Desktop a la vez. Inferencia local opcional para coste $0.
# Clona y arranca (dev)
git clone https://github.com/JoniMartin27/regenta.git
cd regenta
npm install
# API + Desktop a la vez
npm run dev
# → API http://localhost:3000
# → Web http://localhost:5173
# Full-stack a coste $0 (inferencia local + observabilidad)
npm run start:all¿Producción? JWT_SECRET es obligatorio. docker compose up -d --build levanta api + web.
Tú gobiernas. La flota ejecuta.
Dirige agentes de IA con la disciplina de un equipo de ingeniería — sin renunciar al control.
No es magia. Es control.