La idea practica es simple: este repo guarda el contexto, los runbooks y los scripts seguros para que Codex pueda diagnosticar y ayudarte a gestionar el host Proxmox local sin depender de memoria suelta ni de secretos pegados en Markdown.

Estado verificado

Verificado el 2026-05-30 desde esta maquina:

Host Proxmox: 192.168.0.200
Nodo: thinkcentre
Version: Proxmox VE 9.1.1
Kernel: 6.17.2-1-pve
LXC detectados: 100 hermes, 102 coolify
Docker corre dentro del LXC 102
SSH con clave local funciona
API REST autenticada funciona cuando el token se carga desde entorno

Estructura

agent/SKILL.md: reglas operativas para que Codex actue como agente Proxmox.
agent/TOOLS.md: comandos seguros y patrones de uso.
coolify_skill/: skill local para operar Coolify, Docker en LXC 102 y API de Coolify sin guardar secretos.
deploy_skill/: skill para deployar proyectos nuevos a Coolify de punta a punta (scaffold Dockerfile/compose → checklist → repo GitHub → push → alta via API → deploy → verificacion → rollback). Necesita GITHUB_TOKEN y COOLIFY_TOKEN en .env.local.ps1.
gitea_skill/: skill para operar la instancia Gitea self-hosted (crear/listar/ buscar repos, migrar desde GitHub, wire de un remoto gitea y push headless con token inyectado por invocacion — sin persistirlo en .git/config). Necesita GITEA_URL, GITEA_USER, GITEA_TOKEN en .env.local.ps1.
docs/proxmox-inventory.md: inventario verificado y notas de arquitectura.
docs/runbooks/: procedimientos concretos para conexion, diagnostico y Coolify.
docs/runbooks/nextcloud.md: recuperacion y fix HTTPS para Nextcloud.
docs/runbooks/baserow.md: puesta en vivo de Baserow y fix red/Traefik.
docs/casos/: casos verificados paso a paso (ej. chatwoot-enterprise-patch.md).
docs/AGENTS-coolify-apps.md: guia para agentes/LLMs que desarrollan una app destinada a esta instancia de Coolify (reglas de red, puertos, dominios/TLS, env, volumenes, healthchecks) + checklist pre-deploy.
scripts/: wrappers PowerShell para SSH, API e inventario.
PROXMOX/, proxmox-agent/, proxmox-skill/: carpetas legacy que ahora apuntan a la documentacion viva.

Configuracion local

Los secretos no viven en el repo. Usa variables de entorno o un archivo privado ignorado por Git, por ejemplo .env.local.ps1.

Plantilla:

.\scripts\Set-ProxmoxEnv.example.ps1

Prueba de conexion:

.\scripts\Test-ProxmoxConnection.ps1

Inventario rapido:

.\scripts\Get-ProxmoxInventory.ps1

Comando SSH puntual:

.\scripts\Invoke-ProxmoxSsh.ps1 -Command "pct list"

Reglas de operacion

Primero diagnostico de solo lectura.
Cambios destructivos requieren confirmacion explicita: borrar, reiniciar, apagar, editar red, mover discos, actualizar paquetes o modificar servicios.
Preferir scripts del repo antes que comandos manuales largos.
No registrar tokens, passwords ni claves privadas en Markdown.