OctavianTocan/infisical-cli-secrets

Infisical CLI Secrets

Usa la CLI de Infisical como el límite de la fuente de verdad para los secretos: autentica de forma segura, inyecta secretos en procesos con infisical run y evita copiar valores en chats, registros o archivos rastreados. Prefiere la inyección en tiempo de proceso y las superficies de secretos nativas del proyecto sobre los archivos .env escritos a mano.

Variables

• INFISICAL_DOMAIN: dominio autoalojado o en la nube, por ejemplo https://infisical.example.internal.
• INFISICAL_PROJECT_ID: UUID del proyecto Infisical.
• INFISICAL_ENV: slug del entorno, usualmente dev, staging o prod.
• INFISICAL_MACHINE_ENV_FILE: archivo de entorno local opcional que contiene INFISICAL_CLIENT_ID, INFISICAL_CLIENT_SECRET, INFISICAL_DOMAIN e INFISICAL_PROJECT_ID.
• PAWRRTAL_REPO: ruta opcional de checkout de Pawrrtal al aplicar el cookbook de Pawrrtal.

Cómo Funciona

Primero clasifica la superficie de secretos: proceso de desarrollo local, proceso de servicio, CI, o secretos de workspace/usuario propiedad de la aplicación. Luego autentica con inicio de sesión de usuario o identidad de máquina, ejecuta la prueba de humo más pequeña y segura, e inyecta secretos en el límite del proceso con infisical run a menos que la aplicación objetivo tenga su propio almacén de secretos cifrado.

Comandos

Comando	Propósito
/infisical-cli-secrets recon	Inspecciona un repositorio y decide cómo deberían fluir los secretos.
/infisical-cli-secrets auth	Autentica de forma segura con inicio de sesión de usuario o identidad de máquina.
/infisical-cli-secrets run	Envuelve un comando con la inyección de secretos de Infisical.
/infisical-cli-secrets sync	Agrega, actualiza o audita claves secretas sin filtrar valores.
/infisical-cli-secrets pawrrtal	Aplica el patrón limpio a los secretos de gateway y workspace de Pawrrtal.

Cookbook

Cada comando tiene una guía detallada paso a paso. Lee el archivo cookbook correspondiente antes de ejecutar un comando.

Comando	Cookbook	Úsalo Cuando
recon	cookbook/recon.md	Necesitas entender los archivos env, la configuración y los planos de secretos de un repositorio.
auth	cookbook/auth.md	Necesitas una sesión CLI segura o un token de máquina.
run	cookbook/run.md	Necesitas iniciar un comando con secretos inyectados.
sync	cookbook/sync.md	Necesitas establecer, importar, comparar o verificar claves secretas.
pawrrtal	cookbook/pawrrtal.md	El repositorio es Pawrrtal o usa sus convenciones paw/workspace-env.

Cuando un usuario invoque /infisical-cli-secrets, lee primero el archivo cookbook correspondiente, luego ejecuta los pasos.

Reglas de Seguridad

1. Nunca imprimas valores de secretos. Evita infisical secrets --plain, infisical export o printenv a menos que la salida se redirija a un archivo protegido y el usuario lo haya solicitado explícitamente.
2. Prefiere infisical run -- <comando> sobre escribir .env. Usa un archivo solo cuando la herramienta objetivo no pueda aceptar env de proceso, y establece permisos 0600.
3. Para instancias autoalojadas, pasa --domain en cada comando o exporta INFISICAL_API_URL/INFISICAL_DOMAIN.
4. Para identidades de máquina, captura el token en INFISICAL_TOKEN; no pases tokens directamente en cadenas de comandos ni los almacenes en archivos rastreados.
5. Trata las eliminaciones como de alto riesgo. Confirma la intención, verifica el nombre de la clave y el entorno, y prefiere la eliminación por interfaz de usuario/API si se sabe que la ruta de eliminación de la CLI instalada está rota.

Habilidades Relacionadas

Trabaja con: /tailscale, /dev-box, /deploy-checklist