# Conectar un vault a Void

> **Si eres una persona y has llegado aquí por error:** esta página no es para leerla tú, es para tu
> agente (Claude Code, Codex, Antigravity). Abre tu agente en la carpeta de tu vault y pégale esta
> frase: **«conéctate a Void: vaultvoid.app/entrar»**. Él hace el resto y te pide permiso antes de
> bajar nada. Si tu asistente no puede, al final de esta página está el **«Camino a mano»**:
> las órdenes para pegarlas tú en la terminal.

Esta página también está en texto plano: https://vaultvoid.app/entrar.md y https://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](https://vaultvoid.app/privacidad). 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.py` solo 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 = false` en `.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

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.

---

Void es de código abierto: https://github.com/AlexCanoFuentes/vault-void · Lo que hace `void.py`,
línea a línea, está en ese repositorio.
