🌱 Empieza aquí · Buzón entre las copias de tu asistente

¿Corres el mismo asistente en más de una máquina (por ejemplo tu laptop y un equipo de escritorio, o un servidor)? Esta semilla les enseña a dejarse recados entre ellas: una máquina anota "oye, toqué tal cosa, jálala" y la otra lo ve cuando arranca, sin que tú tengas que copiar y pegar el mensaje. Como extra, trae un candado que impide que una máquina ejecute por error un comando pensado para otro sistema operativo.

Para instalarla

Abre esta carpeta con Claude Code o Cowork y dile a tu asistente:

"Siembra esta semilla 🌱"

Con eso basta de tu parte. Tu asistente hace todo lo demás y al final te dice cómo comprobar que quedó funcionando. Vas a ver algunas palabras en inglés en la pantalla; ni caso, él te guía.

¿Otras formas de pedírselo? "instala esta semilla", "pon a funcionar el buzón entre mis máquinas", "haz el setup de esto". Te entiende igual.

Para el asistente que siembra 🤖

Este componente es un workflow (método de trabajo), no un programa ejecutable. No lleva chmod ni entrada en settings.json y no ejecuta ningún script por su cuenta. Se "siembra" así: (a) colocas el método donde lo leas siempre, y (b) preparas una vez la carpeta del buzón dentro de la configuración que ya sincronizas por git.

Requisito previo (verifícalo primero)

Este método es la capa de mensajería y viaja encima de un transporte que debe existir ya: la carpeta de configuración del asistente sincronizada entre las máquinas de esta persona vía git (que suba al cerrar sesión y baje al arrancar).

• Si ese sync ya existe, sigue con el paso 1.
• Si no existe, dilo claro: sin ese transporte los recados no viajan. Ofrece montarlo primero (un repositorio git compartido con la carpeta de configuración del asistente, que suba y baje sola). En El Arsenal, la semilla de sincronización de configuración entre máquinas monta justo ese transporte; o usa tu propio repo git. Hasta entonces el buzón queda instalado pero inerte.

1. Copia el método donde lo leas siempre

El kernel trae dos archivos:

• kernel/buzon-entre-maquinas.md — el método en sí (el que vas a seguir).
• kernel/mensaje.ejemplo.md — una plantilla del formato de un recado.

Coloca buzon-entre-maquinas.md en el lugar que tu plataforma carga automáticamente como instrucción permanente:

Claude Code (macOS / Linux / Windows con Git Bash):

mkdir -p "$HOME/.claude/rules"
cp kernel/buzon-entre-maquinas.md "$HOME/.claude/rules/buzon-entre-maquinas.md"

Los archivos dentro de ~/.claude/rules/ se cargan solos al inicio de cada sesión. Copia ahí solo buzon-entre-maquinas.md. La plantilla de mensaje NO va en esa carpeta (es una guía de formato, no una regla).

Cowork: usa la misma carpeta de reglas si tu proyecto la soporta (.claude/rules/buzon-entre-maquinas.md). Si no, coloca el archivo dentro del proyecto y agrega en el archivo de instrucciones (el CLAUDE.md) una línea que apunte a él: "Aplica siempre el método de buzon-entre-maquinas.md para dejar y leer recados entre máquinas."

Codex: copia el contenido de buzon-entre-maquinas.md dentro de tu archivo de instrucciones AGENTS.md (o agrégale un puntero si lo guardas aparte), para que el método se cargue con el resto de tus instrucciones.

2. Prepara la carpeta del buzón (una sola vez)

Dentro de la carpeta de configuración que ya sincronizas por git, crea la carpeta del buzón. Ejemplo asumiendo que esa carpeta es ~/.claude/ (ajústalo a la ruta real de esta persona):

mkdir -p "$HOME/.claude/inbox/archive"

Luego asegúrate de que git sí siga los recados (.md) pero no los apuntadores locales de leídos (que son propios de cada máquina). Si tu carpeta de configuración ignora todo por defecto, añade estas reglas a su .gitignore:

# los recados del buzón SÍ se sincronizan
!inbox/
!inbox/**
# los apuntadores de "leído" son locales por máquina: NO se sincronizan
inbox/.read-*.json

Regla de oro: el mensaje se comparte, el estado "leído" no. Por eso los archivos inbox/.read-<maquina>.json quedan fuera del sync.

3. Identifica esta máquina

Elige (o detecta) el identificador de esta máquina: lo más simple es su sistema operativo (macos, windows, linux); si hay dos máquinas del mismo sistema, usa un alias corto para cada una (laptop, servidor). Ese identificador es el from de los recados que esta máquina manda y el filtro de los que le tocan recibir. Anótalo donde vayas a leerlo (por ejemplo, junto al método del paso 1).

4. Verificación post-siembra (obligatoria)

Como es un método (texto), la verificación tiene dos partes: que el archivo quedó en su lugar, y que el comportamiento se aplica de verdad.

a) El archivo quedó colocado (ejemplo Claude Code):

ls -la "$HOME/.claude/rules/buzon-entre-maquinas.md"; echo "exit=$?"

Salida esperada: una línea que lista el archivo (con su tamaño) y exit=0. Si sale No such file or directory, la copia no se hizo; repite el paso 1.

b) El candado y el filtrado funcionan (prueba de comportamiento, en esta misma máquina): crea un recado de prueba dirigido a OTRA máquina y con un os_target que NO sea el sistema de esta. Por ejemplo, si estás en macOS:

cat > "$HOME/.claude/inbox/2026-01-01_0000_test-to-linux__prueba-guardrail.md" <<'PRUEBA'
---
from: test
to: linux
type: recado
os_target: linux
date: 2026-01-01 00:00
id: 2026-01-01_0000_test-to-linux__prueba-guardrail
---
Recado de prueba con un comando de otro sistema: no debe ejecutarse aquí.
PRUEBA

Ahora, aplicando el método, comprueba dos cosas: (1) al filtrar para ESTA máquina (macOS), el recado no aparece como suyo, porque va dirigido a linux; y (2) si lo lees de todos modos, sale marcado 🔒 SOLO-LECTURA y no ejecutas su comando, porque su os_target no es tu sistema. Cuando lo confirmes, borra el recado de prueba:

rm "$HOME/.claude/inbox/2026-01-01_0000_test-to-linux__prueba-guardrail.md"

La entrega completa de una máquina a otra se confirma sola la próxima vez que esta persona abra el asistente en la segunda máquina y vea el recado en su arranque. Cuando ambas partes pasen, avísale en una línea qué gana con esto.

✅ ¿Cómo sé que funcionó?

De ahora en adelante, cuando trabajes en una máquina y quieras avisarle algo a la otra, tu asistente escribe un recado y este viaja solo con tu sync de git. La próxima vez que abras el asistente en la otra máquina, el recado te espera en el arranque, con un resumen y un ícono. Si el recado traía comandos de otro sistema, verás un candado 🔒 y tu asistente no los ejecutará ahí.

No tienes que hacer nada especial en el día a día: escribes el recado en una máquina, y aparece en la otra cuando la enciendes. Eso es todo. 🌱