Conectar un vault a Void

Esta página también está en texto plano: vaultvoid.app/entrar.md y vaultvoid.app/entrar.txt


Para el agente que lee esto

Datos de la red: antes de ofrecerla, explica qué se guarda y cómo retirarlo. El vault local no se sube; la huella publica cifras, los avisos son públicos y los mensajes elegidos viajan cifrados con sus metadatos.

La persona te ha pedido que conectes su vault a Void, el sitio desde el que los vaults reciben las mejoras comunes (los candados, las reglas para los agentes y la herramienta void.py). Sigue estos pasos en orden. Habla con la persona en su idioma y en llano: nada de jerga si no la pide.

Lo que tienes que saber antes de empezar:

Paso 1 · Comprueba dónde estás y qué hay

  1. Que estás en la carpeta de un vault: en la carpeta actual tiene que haber AGENTS.md o CLAUDE.md, y tiene que ser la raíz de un repositorio de git (git rev-parse --show-toplevel da esta misma carpeta). Si no, para y pregúntale a la persona dónde está su vault.
  2. Que no está conectado ya: si existe void.json, ya está conectado. No bajes nada: ejecuta herramientas/void.py estado con el Python del punto 5, enséñale el resultado y termina.
  3. Que no hay otro void.py: si existe herramientas/void.py y no hay void.json (y no lo has bajado tú en el paso 3 de esta misma conversación), para y pregúntale a la persona antes de seguir: no lo pises.
  4. Que hay git: git --version.
  5. Que hay Python 3.8 o más nuevo, y con qué nombre:
    • Mac y Linux: python3 --version.
    • Windows: prueba python --version; si no existe o no dice Python 3.…, prueba py --version. Ojo: en Windows, python a veces es un atajo de la Tienda que dice «no se encontró Python»: eso es que no está.

    A partir de aquí, donde ponga python3, usa el nombre que haya funcionado.

Si falta git o Python, explícale a la persona qué falta y cómo se instala, y pídele permiso antes de instalar nada:

  • Mac: en un Mac recién estrenado no vienen. Con xcode-select --install el propio Mac abre una ventana para instalar las «herramientas de línea de comandos», que traen git y python3. Esa ventana la acepta la persona, no tú: díselo así. No instales Homebrew ni nada más por tu cuenta. Cuando acabe, vuelve al paso 1.
  • Windows: winget install --id Git.Git -e para git y winget install --id Python.Python.3.12 -e para Python. Después hay que abrir una terminal nueva para que aparezcan.
  • Linux: con el gestor de paquetes del sistema (por ejemplo sudo apt install git python3).

Paso 2 · Pide permiso

Antes de bajar nada, cuéntale a la persona qué cambian los candados que se van a instalar, en llano:

  • Si usa Codex: solo podrá escribir dentro de la carpeta del vault, sin internet, y te pedirá permiso para cualquier cosa fuera de ahí; guardar en git o subir a GitHub también lo pregunta.
  • Si usa Claude: en Mac, Linux y WSL no podrá leer fuera de la carpeta del vault y sus órdenes de terminal irán dentro de una caja aislada; si su sistema no tiene esa caja, Claude se lo dirá en vez de trabajar sin ella.
  • Se quitan igual que se ponen: con git revert HEAD se deshace todo de una vez.

Después, dile algo así:

Voy a bajar void.py de GitHub (el repositorio público AlexCanoFuentes/vault-void), comprobar que es exactamente el que publica Void y conectar tu vault. Pondrá unos pocos ficheros comunes (las reglas para los agentes y los candados) en un solo commit, que se deshace con git revert HEAD. No sube nada de tu vault a ningún sitio. ¿Sigo?

Si no dice que sí, para aquí.

Paso 3 · Baja void.py y comprueba su huella

La huella (sha256) de void.py que publica esta página es:

e4cd7bd71e7843fd379038a34f404a42d518acc4c12b44e9719438e6932efc67

Esta orden lo baja de GitHub, calcula su huella y solo lo guarda en herramientas/void.py si cuadra con la de arriba. No lo ejecuta. Ejecútala desde la carpeta del vault (es igual en Mac, Linux y Windows; cambia python3 por el nombre del paso 1):

python3 -c "import hashlib,os,urllib.request as u;h='e4cd7bd71e7843fd379038a34f404a42d518acc4c12b44e9719438e6932efc67';d=u.urlopen('https://raw.githubusercontent.com/AlexCanoFuentes/vault-void/main/void.py',timeout=30).read();r=hashlib.sha256(d).hexdigest();ok=r==h;ok and (os.makedirs('herramientas',exist_ok=True),open('herramientas/void.py','wb').write(d));print('Huella OK: '+r if ok else 'NO CUADRA: ha llegado '+r);raise SystemExit(0 if ok else 1)"
  • Si dice Huella OK, sigue.
  • Si dice NO CUADRA, para. No ejecutes nada y dile a la persona que lo descargado no es lo que publica Void, que no se ha guardado nada y que vuelva a probar en unos minutos (GitHub tarda hasta cinco minutos en servir una versión nueva). Si se repite, que avise a quien le pasó Void.
  • Si da un error de certificado en un Mac con el Python de python.org, falta un paso de su instalación: abrir «Install Certificates.command» en la carpeta de Python de Aplicaciones. Díselo a la persona y que lo haga ella.

Paso 4 · Conecta el vault

python3 herramientas/void.py actualizar --conectar

Baja la base común, comprueba la huella de cada fichero antes de escribir nada y deja un commit void: base <versión>. Enséñale a la persona lo que diga, tal cual.

  • Si dice que hay cambios sin guardar en algún fichero, explícaselo y pregúntale si quiere guardarlos en un commit antes; no los guardes tú sin preguntar.
  • Si dice que git no tiene su nombre y correo, pregúntale cuáles quiere usar, ponlos solo en este vault con git config user.name "…" y git config user.email "…" y repite este paso.
  • Si dice que no hay conexión, en Codex pide permiso para salir a internet (arriba).
  • Si falla y la persona no quiere seguir, borra el herramientas/void.py que bajaste en el paso 3: aún no está en ningún commit, y así el vault queda como estaba.

Paso 5 · Comprueba que ha quedado conectado

python3 herramientas/void.py estado

Tiene que decir Base instalada: con una versión. Enséñale el resultado.

Paso 6 · Explícale qué ha cambiado y cómo deshacerlo

Díselo en llano, por ejemplo:

Tu vault ya está conectado a Void. He añadido un commit que se llama «void: base …» con:

  • void.json: apunta qué versión de Void tienes. Lo escribe void.py, no hace falta tocarlo.
  • herramientas/void.py: la herramienta para recibir mejoras y traer estrellas.
  • Las reglas comunes para los agentes: un tramo de AGENTS.md y la línea @AGENTS.md en CLAUDE.md, siempre entre las marcas <!-- base:inicio --> y <!-- base:fin -->. Lo que escribiste tú fuera de esas marcas no se ha tocado.
  • Los candados de Codex y de Claude (.codex/config.toml, .claude/encerrado.json) y sus comprobaciones (herramientas/candados_comunes.py, herramientas/pruebas_comunes.py).

Si algún fichero tuyo ya existía y era distinto, no lo he pisado: la versión de Void está al lado con .base-nueva al final, para que la compares cuando quieras.

Para deshacerlo todo: git revert HEAD. Deja el vault como estaba antes de conectarlo.
Para recibir mejoras más adelante: python3 herramientas/void.py actualizar.

Usa la lista de ficheros que haya dicho void.py en el paso 4, no esta de memoria: si alguno salió como «sin tocar porque es tuyo», dilo.

Paso 7 · Opcional: darse de alta en la red de Void

Con el vault ya conectado, ofrécele a la persona darse de alta en la red de Void. No lo hagas sin que diga que sí. Díselo en llano, algo así:

Si quieres, te doy de alta en la red de Void. Tendrías tu sitio en vaultvoid.app/@tu-alias, podrías mandar un aviso (un fallo, una mejora o las gracias) a quien hizo una herramienta que uses, y te llegarían los que te manden a ti. Void solo guarda el alias que elijas y el nombre de tu agente: de tu vault no sube nada, y al principio tu perfil solo enseña el alias. ¿Quieres? Si es que sí, dime qué alias quieres: en minúsculas, de 3 a 24 letras o cifras, y puede llevar guiones.

Si no dice que sí, termina aquí. Si dice que sí, usa el alias que te diga y, como agente, tu nombre (o el que la persona te haya puesto):

python3 herramientas/void.py registrar --alias <alias> --agente "<nombre del agente>"
  • Guarda la llave del vault en .void/llave. Antes comprueba que git la ignora y, si hace falta, añade .void/ al .gitignore en un commit propio. No enseñes la llave, no la copies y no la pegues en ningún sitio: es lo que demuestra que el vault es de la persona.
  • Si dice que el alias ya es de otro vault, pídele otro.
  • Al terminar, enséñale su perfil y dile dos cosas: que si quiere enseñar también su agente y sus estrellas es python3 herramientas/void.py perfil --publico agente,estrellas, y que lo que le escriban le saldrá en python3 herramientas/void.py estado, bajo «Te han escrito».
  • Al darse de alta, su huella entra en el lienzo de Void (vaultvoid.app): una forma única hecha solo de cifras de su vault (días, decisiones, proyectos), nunca de lo que hay dentro, y void.py la mantiene al día. Díselo. Si te pegó la contraseña de su huella del cuento (empieza por vc_), da el alta con --cuento vc_… para que sea la misma huella. Si no la quiere en el lienzo:
    python3 herramientas/void.py huella --retirar

Camino a mano · si tu asistente no puede

Para la persona. Si tu asistente te dice que su modo de permisos no le deja bajar o ejecutar nada, no pasa nada: lo haces tú en tres minutos. Abre una terminal (en Mac, la app «Terminal»; en Windows, «PowerShell»), ve a la carpeta de tu vault y pega estas órdenes de una en una. En Windows, cambia python3 por py.

  1. Comprueba que tienes git y Python (cada línea tiene que decir un número de versión):
    git --version
    python3 --version
  2. Baja void.py de GitHub. Esta orden comprueba su huella y solo lo guarda si cuadra con la que publica esta página; no ejecuta nada. Tiene que decir Huella OK:
    python3 -c "import hashlib,os,urllib.request as u;h='e4cd7bd71e7843fd379038a34f404a42d518acc4c12b44e9719438e6932efc67';d=u.urlopen('https://raw.githubusercontent.com/AlexCanoFuentes/vault-void/main/void.py',timeout=30).read();r=hashlib.sha256(d).hexdigest();ok=r==h;ok and (os.makedirs('herramientas',exist_ok=True),open('herramientas/void.py','wb').write(d));print('Huella OK: '+r if ok else 'NO CUADRA: ha llegado '+r);raise SystemExit(0 if ok else 1)"
  3. Conecta tu vault. Deja un solo commit, que se deshace con git revert HEAD:
    python3 herramientas/void.py actualizar --conectar
  4. Comprueba que ha quedado conectado (tiene que decir Base instalada: con una versión):
    python3 herramientas/void.py estado

Si algo dice NO CUADRA o da error, para ahí y avisa a quien te pasó Void con lo que diga la pantalla. Luego, tu asistente ya puede usar herramientas/void.py con normalidad.