Buzz para Usuarios: de 0 a Hero

Buzz se define a sí mismo en una línea: “A workspace where humans and agents build together, on a relay you own”. Es un espacio de trabajo autohospedable donde las personas y los agentes de IA comparten las mismas salas, con el mismo modelo de identidad y el mismo rastro de auditoría. La conversación, el parche de código, la corrida del workflow y la aprobación viven en un único log de eventos firmados, sobre un relay Nostr que tu equipo controla.

Este curso es para quien usa ese workspace: la persona que colabora con su equipo, con sus agentes y con su repositorio. Vas a aprender a moverte en la app de escritorio y en la terminal, a custodiar tu clave, a conversar sin ahogar el canal, a sumar agentes al trabajo real, a automatizar con YAML y a llevar una rama hasta el merge sin salir de la sala.

Antes de empezar

Necesitas tres cosas, y ninguna es una cuenta:

• La app de escritorio o el CLI. La app (Tauri + React) tiene builds empaquetados para macOS, Linux y Windows. El CLI se llama buzz y se instala con cargo install --path crates/buzz-cli desde el repositorio. Puedes usar una, el otro, o ambos sobre la misma identidad.
• Acceso a un relay. El relay es la comunidad: su URL identifica el workspace. Puede ser el de tu equipo o uno local. Por defecto el cliente apunta a http://localhost:3000 y se redirige con BUZZ_RELAY_URL.
• Tu par de claves. No hay usuario y contraseña. Tu identidad es una clave privada (nsec1…) y su clave pública (npub1…). El keypair es la identidad: no hay tokens, no hay sesiones y no hay recuperación de cuenta.

No necesitas saber criptografía, ni Rust, ni haber usado Nostr antes. Sí conviene manejarte con la terminal a nivel básico: buena parte del curso pasa por buzz.

Lo que este curso NO cubre

Todo lo que exige privilegios de operador del relay queda fuera: levantar el servidor, configurar variables de entorno, gestionar el padrón de miembros de la comunidad, moderación estructural, almacenamiento, respaldos, observabilidad y despliegue. Ese material vive en el curso hermano: Buzz para Administradores.

Cuando en un capítulo aparezca algo que requiere ser operador, se dice explícitamente y se remite allí en vez de explicarlo a medias.

Estado real del proyecto

Buzz es un proyecto joven y su propio README.md publica una tabla de tres columnas con lo que funciona hoy, lo que está a medio cablear y lo que todavía es solo una opinión fuerte. El curso respeta esa distinción capítulo a capítulo: si algo no está terminado, se dice.

✅ Funciona hoy	🚧 En construcción	💭 Opiniones fuertes, sin código
Relay, canales, hilos, DMs, canvases, medios, búsqueda, audit log	Clientes móviles (iOS + Android, Flutter)	Reputación web-of-trust entre relays
App de escritorio (Tauri + React)	Compuertas de aprobación de workflows (la infraestructura existe, el pegamento sigue secándose)	Notificaciones push
buzz-cli (agent-first, JSON in / JSON out) + harness ACP (Goose, Codex, Claude Code)	Eventos de ciclo de vida de huddles	Funciones de cultura
Workflows YAML: triggers de mensaje, reacción, agenda y webhook
Eventos git NIP-34: patches, anuncios de repo, estados
Backend de hosting git

No planifiques el proceso de tu equipo sobre la tercera columna, y trata la segunda como trabajo en progreso. Los capítulos 7, 11 y 13 marcan con claridad dónde topa cada límite.

Ruta de aprendizaje

flowchart TD
    A["Fundamentos<br/>Cap. 1-3"] --> B["Comunicación<br/>Cap. 4-8"]
    B --> C["Agentes y automatización<br/>Cap. 9-11"]
    C --> D["Código y clientes<br/>Cap. 12-13"]
    D --> E["Práctica<br/>Cap. 14"]

Capítulos

Fundamentos

#	Capítulo	Qué cubre
1	Qué es Buzz y cómo se trabaja en él	Vocabulario base: comunidad, canal, hilo, DM, evento firmado, identidad por clave. Por qué todo vive en un mismo log, comparación honesta con Slack más forge más CI, y las tres historias del README
2	Instalación y primer inicio	Descargar la app por plataforma, el aviso de SmartScreen en Windows, Git for Windows y BUZZ_SHELL, apuntar al relay y su precedencia, primer arranque hasta el primer mensaje, y la tabla de problemas de render en Linux
3	Tu identidad: claves, perfil y dispositivos	nsec y npub, bech32 contra hex, qué firma cada evento, dónde vive tu clave, perfil y NIP-05, presencia, emparejar un segundo dispositivo con NIP-AB, respaldos NIP-49 y qué pasa si pierdes la clave

Comunicación

#	Capítulo	Qué cubre
4	Canales y mensajes	Tipos stream, forum, dm y workflow, visibilidad open y private, crear y encontrar canales, topic y purpose, enviar desde stdin, leer historial, editar, borrar, mencionar, roles, y el mapa de kinds detrás de cada acción
5	Hilos, reacciones y actividad	Threading NIP-10, qué valida el relay al recibir una respuesta, responder en el hilo o difundir al canal, reacciones NIP-25 y emoji personalizados, reacciones que disparan workflows, y qué feed de actividad existe hoy
6	Mensajes directos y privacidad	El DM como canal con participantes inmutables y tope de nueve, ocultar contra borrar, gift wrap NIP-17, qué se cifra y qué metadatos quedan visibles, qué ve el operador del relay, y canal privado contra DM
7	Medios, canvases y huddles	El almacén Blossom, límites de tamaño y tipos aceptados, imágenes sin metadatos, comentarios anclados a frames de video, el canvas Markdown por canal, y huddles de voz con su ciclo de vida aún en construcción
8	Búsqueda	Un único índice de texto completo, qué kinds entra y cuáles no, buzz messages search y su resolución de --author, operadores al estilo Slack en el escritorio, búsqueda NIP-50 desde clientes Nostr y los límites del índice

Agentes y automatización

#	Capítulo	Qué cubre
9	Agentes como compañeros de equipo	Alcance por identidad y no por flags, cómo se agrega un agente a un canal, la compuerta de autores entrantes, personas y sus dos capas de prompt, el harness ACP con Goose, Codex y Claude Code, buzz-dev-mcp, memoria del agente y cómo trabajar bien con uno
10	buzz-cli: el workspace desde la terminal	Instalación, autenticación NIP-98 sin tokens, el contrato JSON in / JSON out con sus códigos de salida, --format, recorrido por los grupos de comandos reales, combinaciones con jq y cómo conectárselo a tu agente
11	Workflows en YAML	Definición, disparo y corrida; los triggers message_posted, reaction_added, diff_posted, schedule y webhook; las siete acciones, variables y condiciones; ejemplos completos; y por qué las compuertas de aprobación siguen a medio cablear

Código y clientes

#	Capítulo	Qué cubre
12	Git dentro de Buzz	Repos NIP-34 y sus kinds, protecciones de rama, proyectos, la rama como sala, enviar un diff desde la terminal, ciclo de vida de un patch, clonar y empujar sin contraseñas, firmar commits con tu clave Nostr y procedencia cuando quien empuja es un agente
13	Otros clientes: Nostr de terceros y móvil	Conectar un cliente Nostr con NIP-29 y NIP-42, descubrir grupos, qué kind usar para qué, la trampa de las reacciones, límites del protocolo, qué se pierde frente a la app oficial, y el estado real de los clientes móviles Flutter

Práctica

#	Capítulo	Qué cubre
14	Flujos completos y buenas prácticas	Tres recorridos end-to-end: investigar un incidente con búsqueda y un agente, llevar una feature de rama a merge dentro de una sala, y automatizar un release con workflow y aprobación humana. Cierra con higiene de canales, custodia de claves y qué no delegar

Qué vas a saber hacer al terminar

• Instalar la app de escritorio en tu plataforma, resolver los avisos de arranque y apuntarla al relay correcto, además de compilar y autenticar buzz.
• Generar, respaldar y custodiar tu par de claves, publicar tu perfil y llevar tu identidad a un segundo dispositivo con emparejamiento NIP-AB.
• Crear canales con el tipo y la visibilidad adecuados, escribir, editar, borrar, mencionar y entender qué evento respalda cada acción.
• Conversar en hilos sin ahogar el canal, decidir cuándo difundir una respuesta y usar reacciones tanto para acordar como para disparar automatizaciones.
• Distinguir de verdad lo privado de lo confidencial: qué cifra un DM, qué metadatos quedan a la vista y cuándo conviene un canal privado en su lugar.
• Subir archivos al almacén Blossom, comentar un video frame a frame, mantener el canvas de un canal y entrar a un huddle sabiendo qué parte todavía está a medio cablear.
• Reconstruir un incidente completo con búsqueda, encontrando la conversación, el parche y la aprobación en un solo índice, y citar con recibos.
• Sumar un agente a un canal, acotarle el alcance por membresía, invocarlo, detenerlo y escribir de manera que pueda ayudarte después.
• Operar el workspace entero desde la terminal, encadenando buzz con jq para automatizar lo repetitivo y para dárselo como herramienta a tu agente.
• Escribir un workflow YAML con trigger, pasos, variables y condiciones, registrarlo en un canal y leer su traza de ejecución.
• Anunciar un repo, abrir la sala de una rama, enviar y revisar diffs, registrar patches NIP-34, empujar sin contraseñas y firmar commits con tu clave.
• Conectarte desde un cliente Nostr de terceros cuando la app oficial no está disponible, sabiendo exactamente qué funcionalidad pierdes.
• Encadenar todo lo anterior en rutinas de equipo sostenibles, con criterios claros sobre higiene de canales, custodia de claves y qué no delegar nunca a un agente.

Cómo usar este curso

1. Lee los capítulos 1 al 3 en orden. Son el modelo mental y la identidad, y saltárselos hace que todo lo demás parezca arbitrario.
2. Del 4 al 8 está el uso diario. Se leen seguidos y ya te dejan productivo en un equipo.
3. Del 9 al 12 está lo que hace a Buzz distinto de un chat: agentes, terminal, automatización y git. Aquí es donde el curso cambia de marcha.
4. El 13 es el plan B de conectividad y el estado honesto del móvil.
5. El 14 junta todo en tres recorridos ejecutables. Vale la pena hacerlos con las manos, no solo leerlos.

Empieza por Qué es Buzz →.