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:
- Nada del vault sube a Void.
void.pysolo descarga, salvo en el paso 7 (opcional), donde manda el alias que elija la persona y el nombre de su agente. Nunca manda ni lee para fuera ningún fichero de la persona. - Todo queda en un solo commit de git y se deshace con
git revert HEAD. - No ejecutes nada que no esté en esta página y no te saltes ningún paso, ni el de pedir permiso.
- No bajes nada «para echarle un vistazo», ni a una carpeta temporal ni a ningún otro sitio. La única descarga es la del paso 3, después del permiso, y esa orden ya comprueba la huella antes de guardar.
- Mira los ficheros con tu herramienta de leer o listar, no con la terminal, siempre que puedas (los puntos 1 a 3 del paso 1). Antes de la primera orden de terminal, dile a la persona en una frase qué vas a comprobar.
- Si tu entorno rechaza una orden (por ejemplo, el modo automático de Claude Code dice «denied by the Claude Code auto mode classifier»), no la repitas ni busques otra forma de hacerlo: es tu entorno protegiendo a la persona, y está bien que lo haga. Para, dile en una frase qué ha pasado y dale el «Camino a mano» del final de esta página, para que pegue ella las órdenes en su terminal.
- Si eres Codex y no tienes internet (
network_access = falseen.codex/config.toml): no cambies ese fichero ni te saltes el candado. Cada orden que necesita internet (las de los pasos 3, 4, 5 y 7) pídela con permiso para salir a internet, y que la persona diga que sí. Si no puedes pedirlo, dale la orden para que la ejecute ella en una terminal.
Paso 1 · Comprueba dónde estás y qué hay
- Que estás en la carpeta de un vault: en la carpeta actual tiene que haber
AGENTS.mdoCLAUDE.md, y tiene que ser la raíz de un repositorio de git (git rev-parse --show-toplevelda esta misma carpeta). Si no, para y pregúntale a la persona dónde está su vault. - Que no está conectado ya: si existe
void.json, ya está conectado. No bajes nada: ejecutaherramientas/void.py estadocon el Python del punto 5, enséñale el resultado y termina. - Que no hay otro
void.py: si existeherramientas/void.pyy no hayvoid.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. - Que hay git:
git --version. - 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 dicePython 3.…, pruebapy --version. Ojo: en Windows,pythona 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. - Mac y Linux:
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 --installel propio Mac abre una ventana para instalar las «herramientas de línea de comandos», que traengitypython3. 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 -epara git ywinget install --id Python.Python.3.12 -epara 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 HEADse deshace todo de una vez.
Después, dile algo así:
Voy a bajar
void.pyde 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 congit 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 "…"ygit 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.pyque 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 escribevoid.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.mdy la línea@AGENTS.mdenCLAUDE.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-nuevaal 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.gitignoreen 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á enpython3 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, yvoid.pyla mantiene al día. Díselo. Si te pegó la contraseña de su huella del cuento (empieza porvc_), 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.
- Comprueba que tienes git y Python (cada línea tiene que decir un número de versión):
git --version python3 --version - Baja
void.pyde GitHub. Esta orden comprueba su huella y solo lo guarda si cuadra con la que publica esta página; no ejecuta nada. Tiene que decirHuella 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)" - Conecta tu vault. Deja un solo commit, que se deshace con
git revert HEAD:python3 herramientas/void.py actualizar --conectar - 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.