Confirmación atendida

kovra confirm expone el broker de aprobación de kovra como una primitiva independiente. Le pide a una persona que haga un bioProve de una acción descrita y sale con 0 si se aprueba, distinto de cero si se deniega o expira — de modo que cualquier app o script de confianza puede proteger su propia acción detrás de una persona real, igual que se protege la revelación de un secreto.

Es independiente de los secretos: no necesita vault ni master key. Simplemente abre el broker, muestra la descripción como el prompt autoritativo y reporta el veredicto a través de su exit code.

zsh

~ % kovra confirm "Promote build 1.2.3 to staging"
Approval required: Promote build 1.2.3 to staging
Approve at the system prompt (Touch ID, or your login password). Waiting…
Approved.

En una Mac — la plataforma para la que se entrega kovra 0.12.1 — la aprobación se lee y se aprueba en la ventana de revisión de kovra, con el sensor de Touch ID dentro de ella (vea Las demás aprobaciones más abajo). El diálogo de macOS se abre solo cuando usted hace clic en la huella o, si la Mac no tiene Touch ID (o no está configurado), después de que la ventana muestra un código corto. Por SSH, o donde no haya sesión gráfica, no se puede mostrar la ventana: con un teléfono vinculado, kovra confirm pregunta en la app de aprobación de kovra en ese teléfono (kovra Mobile, próximamente); sin teléfono vinculado, deniega y sale con un código distinto de cero: ejecútelo desde el escritorio de la Mac. No hay una vía alternativa que un agente o un script pueda responder por sí mismo. (kovra approve es para builds de desarrollo y plataformas que 0.12.1 no entrega, y se niega dentro de una sesión de Claude Code.)

Proteger la propia acción

Como el veredicto es un exit code, conectarlo a un script es una sola línea:

if kovra confirm "Deploy to production"; then
  ./deploy.sh
else
  echo "Denied — not deploying."
fi

--ttl <seconds> acota cuánto espera antes de fallar de forma segura hacia una denegación (120s por defecto, 300s como máximo: un valor mayor es un error de uso).

La descripción es texto de confianza

La descripción se trata como texto de confianza del invocador — es lo que la persona está aprobando. Nunca se le debe pasar entrada no confiable o generada por un LLM, o se le permitiría a un invocador escribir las mismas palabras usadas para engañar a quien aprueba. Para que no pase por una aprobación propia de kovra, kovra la presenta como del programa que llama — A program — not kovra — asks you to approve — y la muestra escapada, en un marco que dice que no es de kovra, de modo que no puede agregar líneas que se lean como propias de kovra.

Ejecuciones con secretos de producción

Un kovra run que entrega un valor high o prod se aprueba, en cambio, en la ventana de revisión de kovra, con el sensor de Touch ID dentro de ella. La ventana muestra el comando y el archivo que se ejecuta, la carpeta, qué variable recibe cada secreto (⚠ PROD marca producción) y quién lo pide. Léala y toque el sensor para aprobar; presione Esc o ✕ para denegar. Esc y ✕ no hacen nada durante el primer segundo y medio, para que una tecla que estaba escribiendo en otra app no deniegue por accidente, y la ✕ se llena a medida que se acaba el tiempo.

• El sensor escucha solo mientras usted puede estar leyendo la ventana: tiene el foco, ninguna ventana de otra app está por encima de ella en ninguna parte de la pantalla ni a su lado sin el oscurecimiento que kovra pone sobre el resto de la pantalla, y se mantiene quieta y completa en una pantalla durante un momento. La línea bajo el comando dice qué está haciendo el sensor.
• Si la ventana pierde el foco, no lo obtiene en su primer medio segundo, o una ventana de otra app queda por encima, Touch ID espera a que usted haga clic en la ventana (Click this window to enable Touch ID), y el lugar del sensor muestra el símbolo de Touch ID atenuado y tachado, como deshabilitado. Solo cuenta un clic de su mouse o trackpad: un clic generado por otro programa no.
• Haga clic en la huella para responder en el diálogo de macOS, con el texto completo de la ejecución; acepta Touch ID o la contraseña de su sesión. Mientras la ventana espera su clic, un clic sobre el símbolo tachado hecho por una herramienta de accesibilidad u otro programa también abre ese diálogo, de modo que puede aprobar con Control por botón, Control por voz, el Teclado de accesibilidad o un control remoto. Un clic de su propio mouse o trackpad ahí nunca abre el diálogo: activa Touch ID (si la ventana todavía no tenía el foco, el primer clic solo se lo da). Si una ventana de otra app queda sobre la ventana de revisión o sobre el diálogo de macOS, kovra cancela el diálogo y la ventana vuelve a esperar su clic.
• Sin Touch ID en ese momento (sin sensor, sin huella registrada, bloqueado), o si falla el sensor de la ventana, la ventana muestra un código corto y un botón Approve with Touch ID, y el diálogo de macOS que sigue repite el código.

Solo hay una ventana de revisión abierta a la vez: un segundo pedido espera a que se cierre el primero, y esa espera cuenta contra su tiempo.

Las demás aprobaciones

En una Mac toda otra aprobación —revelar un valor o un código de un solo uso, borrar, reemplazar, crear un secreto prod, firmar (también el agente ssh), abrir el dashboard y kovra confirm— se lee y se aprueba en la misma ventana, con las mismas reglas: el sensor dentro de ella, o el código y el diálogo de macOS sin Touch ID. La ventana muestra los mismos datos que mostraría el diálogo, cada uno completo por largo que sea: qué se aprueba, el entorno (⚠ PROD para producción), el proyecto, el secreto y quién lo pide. El texto que escribió un llamador se muestra al final, en un marco que dice que no es de kovra. Para una revelación la ventana dice además adónde va el valor, y nunca lo muestra: kovra lo imprime solo después de que la ventana se cerró. Para kovra confirm el título de la ventana es siempre A program — not kovra — asks you to approve, con el texto del programa en un marco propio. Un clic en la huella abre el diálogo de macOS con el texto completo, o con uno corto que remite a la ventana cuando el texto no cabe; para una revelación ese diálogo acepta solo Touch ID.

Un sonido cuando kovra pide aprobar

Un agente puede pedirle una aprobación mientras usted mira otra cosa. Por eso, en una Mac, cada pedido que abre kovra suena una sola vez, al aparecer, con un doble clic muy suave. Sigue el volumen de la Mac (con la Mac en silencio no suena) y nunca suena dos veces por el mismo pedido.

Para apagarlo, desmarque Sound for Approvals en el menú de kovra de la barra de menús; márquelo otra vez para encenderlo. El sonido es solo un aviso: encendido o apagado, cada aprobación es igual.

Aprobar desde su iPhone

kovra Mobile llega próximamente (todavía no está publicada). Con la app vinculada, cada aprobación también se puede responder en el teléfono con Face ID, y por SSH el teléfono es el único lugar donde aprobar. Vea Aprobar desde su iPhone. Para saber de antemano si algo le pedirá aprobación, vea Preflight.