Guardrails para OpenAI Codex, hechos con tus propias reglas.

Las reglas de tu empresa llegan a Codex antes de cada parche. Lo que nunca debe hacer se bloquea antes de ejecutarse.

npx -y @cybedefend/vibedefend@latest install

Crear una cuenta gratisCualquier versión reciente de OpenAI CodexLeer la documentación

OpenAI Codex está escribiendobilling/refund.ts

export async function refund(req: Request) {
  const { id, amount } = await req.json();
  const invoice = await db.invoices.find({
    id, tenant: req.tenant,
  });
  if (amount > 500)
    await approvals.second(invoice);
  return payments.refund(invoice, amount);
}

Cada consulta se limita al tenant.

rules/data-access.md

Los reembolsos de más de 500 € necesitan un segundo aprobador.

Aprobada una vez por Sofia M.

Revisado antes del commit: limpio

Listo en cuatro pasos.

Ejecuta un comandoEn cualquier terminal, en macOS, Linux o Windows. Node 18.17 o posterior.
Elige la región e inicia sesiónUE o EE. UU. Tu navegador se abre para iniciar sesión, sin clave que pegar.
Marca OpenAI CodexEl instalador encuentra los agentes de tu equipo y los marca por ti.
Programa como siempreUna sola vez, en Codex: ejecuta /hooks y aprueba las entradas cybedefend.

Compruébalo cuando quieras: vibedefend status

Lo que VibeDefend añade a OpenAI Codex.

Reglas servidas

Tus reglas de negocio y de seguridad llegan a OpenAI Codex antes de cada edición.

OpenAI Codex está escribiendosrc/billing/cart-checkout.ts

const total = new Decimal128(cart.sum);
const rows = await db.query(
  "SELECT * FROM carts WHERE id = $1", [id]
);

Los importes usan Decimal128, nunca Number.

Extraída de src/billing.ts:14

Toda consulta que mezcla datos del usuario va parametrizada.

OWASP Top 10

Servidas antes de la edición

Protección de secretos

Las lecturas directas de secretos se rechazan; OpenAI Codex recibe la referencia gestionada.

OpenAI Codexwebhooks.ts

cat .env | grep STRIPE
Bloqueado: lectura directa de un secreto
En su lugarprocess.env.STRIPE_WEBHOOK_SECRET
npm test -- webhooks
Los tests pasan

Registrado para el equipo

Control de acciones

Comandos destructivos, borrados de esquema y rutas protegidas se detienen antes de ejecutarse.

OpenAI Codex

rm -rf dist/
Permitido: salida del build
rm -rf .cache/
Permitido: caché
rm -rf ./storage/uploads
Bloqueado: ruta protegida, archivos de los usuarios

Registrado para el equipo

Hallazgos en vivo

Los hallazgos de SAST, SCA, secretos, IaC y CI/CD, en vivo en la sesión.

OpenAI Codex

SASTsrc/db/users.repo.ts:42
SQL injection
SCApackage.json
lodash 4.17.20, CVE-2021-23337
Secretsconfig/prod.yml
AWS access key
IaCinfra/main.tf
S3 bucket public-read
CI/CD.github/workflows/deploy.yml
pull_request_target

En el contexto del agente, en vivo

Preguntas frecuentes.

¿VibeDefend modifica mi configuración de OpenAI Codex?

Añade sus hooks y registra el servidor MCP cybedefend, en ~/.codex/hooks.json, ~/.codex/config.toml. Tus propios hooks se mantienen: volver a ejecutar el instalador solo sustituye las entradas de VibeDefend.

¿Qué sale de mi máquina?

El análisis se ejecuta en la región que elegiste al instalar, UE o EE. UU. La decisión de bloquear una acción se toma en tu máquina. Antes de una edición, el hook envía la parte del archivo que se está escribiendo, para encontrar las reglas que se aplican. La revisión de fin de sesión envía los archivos que se modificaron durante la sesión. Tu token de inicio de sesión se queda en el llavero de tu sistema operativo.

¿Qué versión de OpenAI Codex necesito?

Una versión reciente de OpenAI Codex, y Node 18.17 o posterior. El instalador funciona en macOS, Linux y Windows.

¿Tengo que vincular cada repositorio?

No en los proyectos importados desde GitHub o GitLab: VibeDefend lee el origin del repositorio y encuentra el proyecto. Para cualquier otro repositorio, ejecuta vibedefend link una vez. El comando escribe .cybedefend/config.json con el ID del proyecto.

¿Cómo lo desinstalo?

Ejecuta vibedefend uninstall: elimina todos los archivos que instaló VibeDefend. Si instalaste el paquete de forma global, ejecuta después npm uninstall -g @cybedefend/vibedefend.

¿Por qué los hooks aparecen como Active 0 en Codex?

Codex 0.131 y posteriores dejan los hooks nuevos en reposo hasta que los apruebas. Abre Codex, ejecuta /hooks y marca como de confianza las entradas cybedefend.

Detalles técnicos para OpenAI Codex

Servidor MCP: Disponible~/.codex/config.toml
Reglas antes de cada edición: DisponiblePreToolUse^(Edit|Write|apply_patch|Bash)$Antes de apply_patch, de las ediciones y de los comandos de shell que escriben archivos. Con los comandos de solo lectura no se recupera nada.
Acciones peligrosas bloqueadas: DisponiblePreToolUse
Reglas cargadas al inicio: DisponibleSessionStart
Revisión al final de la sesión: DisponibleStop
Revisión de las sesiones largas: No disponibleSin equivalenteCodex no tiene ningún evento previo a la compactación.
Recordatorio en cada prompt: Con el servidor MCPServer.instructionsCodex recibe las instrucciones de CybeDefend del servidor MCP en cada sesión, así que no necesita recordatorio.

Lo que escribe para OpenAI Codex

~/.codex/hooks.json
~/.codex/config.toml

Además, el runner de los hooks en ~/.cybedefend/. Tus propios hooks se mantienen: volver a ejecutar el instalador solo sustituye las entradas de VibeDefend.

Aprueba los hooks una vez. Codex 0.131 y posteriores te piden confiar en cada hook: abre Codex, ejecuta /hooks y marca como de confianza las entradas cybedefend. Hasta entonces, el panel muestra Installed N, Active 0.

Un inicio de sesión más, solo una vez: el token MCP de Codex no puede llamar a los endpoints que usan los hooks. El instalador también pone hooks = true en ~/.codex/config.toml por ti.

¿Algo no va bien? vibedefend status da un informe de solo lectura, y vibedefend doctor repara lo que puede.