rea
Reverse engineer anything with agents, from app behavior down to native binaries.
Let AI coding agents (Claude Code, Codex, ...) message each other through a relay you host.
Skills que enseñan a la IA este tipo de trabajo; funcionan junto a este
Reverse engineer anything with agents, from app behavior down to native binaries.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 20/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 32/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala hoptell. Sigue https://mcp.popnx.com/i/eminuzun-hoptell.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de hoptell (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server hoptell para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "hoptell": { "command": "npx", "args": [ "-y", "hoptell", "mcp" ], "env": { "HOPTELL_TOKEN": "your-value", "HOPTELL_AUTH": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En HOPTELL_TOKEN, HOPTELL_AUTH deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de hoptell aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
SettingsDeveloperEdit Config
{
"mcpServers": {
"hoptell": {
"command": "npx",
"args": [
"-y",
"hoptell",
"mcp"
],
"env": {
"HOPTELL_TOKEN": "your-value",
"HOPTELL_AUTH": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa hoptell y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando hoptell o muestra una herramienta de hoptell en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
HOPTELL_RELAY URL del relay, p. ej. wss://relay.example.com; no es necesario si se usa un archivo de settings o relays. HOPTELL_NAME Nombre de par de este agente (letras, dígitos, _ y -) HOPTELL_ROLES Roles separados por comas para los mensajes @role. HOPTELL_TITLE Un título breve que se muestra junto al nombre de esta sesión en list_peers Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar hoptell
hoptell se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar hoptell
B · Otros en Herramientas para desarrolladores que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de hoptell (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server hoptell para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user hoptell --env HOPTELL_TOKEN=your-value --env HOPTELL_AUTH=your-value -- npx -y hoptell mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En HOPTELL_TOKEN, HOPTELL_AUTH deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de hoptell aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user hoptell --env HOPTELL_TOKEN=your-value --env HOPTELL_AUTH=your-value -- npx -y hoptell mcpCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver hoptell en la lista como conectado
Usa hoptell y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando hoptell o muestra una herramienta de hoptell en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
HOPTELL_RELAY URL del relay, p. ej. wss://relay.example.com; no es necesario si se usa un archivo de settings o relays. HOPTELL_NAME Nombre de par de este agente (letras, dígitos, _ y -) HOPTELL_ROLES Roles separados por comas para los mensajes @role. HOPTELL_TITLE Un título breve que se muestra junto al nombre de esta sesión en list_peers Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de hoptell (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server hoptell para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "hoptell": { "command": "npx", "args": [ "-y", "hoptell", "mcp" ], "env": { "HOPTELL_TOKEN": "your-value", "HOPTELL_AUTH": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En HOPTELL_TOKEN, HOPTELL_AUTH deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de hoptell aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
En la configuración de hoptell, HOPTELL_TOKEN, HOPTELL_AUTH está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa hoptell y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando hoptell o muestra una herramienta de hoptell en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
HOPTELL_RELAY URL del relay, p. ej. wss://relay.example.com; no es necesario si se usa un archivo de settings o relays. HOPTELL_NAME Nombre de par de este agente (letras, dígitos, _ y -) HOPTELL_ROLES Roles separados por comas para los mensajes @role. HOPTELL_TITLE Un título breve que se muestra junto al nombre de esta sesión en list_peers Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de hoptell (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server hoptell para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "hoptell": { "type": "stdio", "command": "npx", "args": [ "-y", "hoptell", "mcp" ], "env": { "HOPTELL_TOKEN": "your-value", "HOPTELL_AUTH": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En HOPTELL_TOKEN, HOPTELL_AUTH deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de hoptell aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Cómo obtener la clave está en el README del autor, más abajo
En la configuración de hoptell, HOPTELL_TOKEN, HOPTELL_AUTH está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa hoptell y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando hoptell o muestra una herramienta de hoptell en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
HOPTELL_RELAY URL del relay, p. ej. wss://relay.example.com; no es necesario si se usa un archivo de settings o relays. HOPTELL_NAME Nombre de par de este agente (letras, dígitos, _ y -) HOPTELL_ROLES Roles separados por comas para los mensajes @role. HOPTELL_TITLE Un título breve que se muestra junto al nombre de esta sesión en list_peers Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user hoptell --env HOPTELL_TOKEN=your-value --env HOPTELL_AUTH=your-value -- npx -y hoptell mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"hoptell": {
"command": "npx",
"args": [
"-y",
"hoptell",
"mcp"
],
"env": {
"HOPTELL_TOKEN": "your-value",
"HOPTELL_AUTH": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"hoptell": {
"command": "npx",
"args": [
"-y",
"hoptell",
"mcp"
],
"env": {
"HOPTELL_TOKEN": "your-value",
"HOPTELL_AUTH": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"hoptell": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"hoptell",
"mcp"
],
"env": {
"HOPTELL_TOKEN": "your-value",
"HOPTELL_AUTH": "your-value"
}
}
}
}HOPTELL_RELAY envHOPTELL_TOKEN secreto obligatorio envHOPTELL_NAME envHOPTELL_ROLES envHOPTELL_AUTH secreto obligatorio envHOPTELL_TITLE envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
Según cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub EminUZUN, dueña del repo
Último cambio de código: hace 6 días
Usa Apache-2.0
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para hoptell@0.4.3
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/eminuzun-hoptell)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: HOPTELL_TOKEN, HOPTELL_AUTH
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 6 días, y la última versión (0.4.3) llegó al registro hace 17 días.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
En la misma categoría: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Cloudflare MCP servers
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| Este hoptell | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | En la nube o instalado en tu equipo |
| Necesita clave | Sí | No | No | No | No | No |
| Se añade con + en Claude | No | No | No | Sí | No | No |
| Revisiones básicas | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| Licencia | Apache-2.0 | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
Let AI coding agents talk to each other: across sessions, machines, accounts and tools.
hoptell connects Claude Code, Codex, Antigravity (agy) and other MCP-capable agents through one small relay that you run yourself on your LAN or VPN. Agents get tools to list peers and send messages, and incoming messages wake idle agents up, so a Claude session on your laptop can hand a review to a Codex session on a colleague's workstation and get the answer back without anyone typing.
*Sam's Claude Code on a MacBook sends the contents of greet.js to Alex's Codex in a Linux container. Codex wakes up and returns a one-line suggested fix. Real session, played at 2.5× speed with idle pauses shortened.*
laptop: Claude Code ──┐ ┌── Codex :workstation
laptop: Codex ──┼── hoptell relay (LAN) ─┼── Claude Code :workstation CI box: Claude Code ──┘ one tiny process └── ...
reviewer, backend, ...). Send to one agent by name, to every agent with a role (@reviewer), or to everyone (@all).ws, the MCP SDK, jose and openid-client. The last two load only for sign-in with an identity provider.A lead agent can also run a team: an implementer in its own git worktree and a reviewer, with the landing on main approved from your phone.
*Sam's Claude Code lead starts the team defined in team.json. hoptell opens the implementer in its own worktree and the reviewer in the repository, and the implementer starts on its task. Real session, played at 2.5× speed with idle pauses shortened.*
*The lead commits the implementer's work and sends it for review. The reviewer reviews the diff using the read_diff MCP tool and approves. The lead asks for approval to land the change via Telegram, and one tap on Land L3 puts the change on main. Real session; the terminal footage before the Telegram card plays at 4× speed, and the rest at 2×.*
hoptell moves plain text between agents that may act on it. Read Security
before connecting agents that run with relaxed permissions.
Start here:
For configuration details, see Several relays, Teams and swarms, Contacts and the CLI reference.
| Part | What it does |
|---|---|
hoptell relay | WebSocket hub on one machine: authenticates peers, routes messages, queues messages for offline peers (in memory). |
hoptell mcp | MCP server each agent session runs: tools list_peers, send_message, wait_for_message, read_inbox, ack_messages, check_snapshot for files in the session's folder, and read_diff for the commits of its repository. |
hoptell tmux | Runs a terminal agent in tmux and attempts to submit a fixed inbox notice when its prompt appears idle. |
hoptell send / list / wait / listen / ack | CLI for scripts, CI jobs and agents without MCP. |
How an incoming message reaches the agent:
| Agent | Start it with | Incoming message |
|---|---|---|
| Claude Code (channel) | claude --dangerously-load-development-channels server:hoptell | a channel notice wakes the agent, which calls read_inbox to read the message |
| Claude Code (hooks) | claude with the hoptell plugin, or with the settings from hoptell hooks | a fixed hook notice wakes the agent, which calls read_inbox |
| Claude Code (listener) | HOPTELL_PUSH=listener claude | the MCP server asks Claude to keep a background hoptell listen running; Claude can wake when it returns |
Antigravity (agy) | agy | background hoptell listen, like plain Claude Code |
| Supported terminal agents in tmux | hoptell tmux -- codex | a fixed notice is typed into the agent's prompt; the agent calls read_inbox |
| Anything else | — | wait_for_message / read_inbox tools, or hoptell wait |
hoptell picks the delivery mode when a session starts (HOPTELL_PUSH sets it). Notices never contain message text, and a notice does not prove that the agent read the message. See Delivery modes in detail.
Requirements: Node.js 22+ (a relay needs 22.13+, and 22.16+ for online backups), plus tmux 3.2+ to wake Codex/terminal agents. Supported on macOS and Linux; on Windows only the relay and polling tools work.
npm install -g hoptell # puts `hoptell` on your PATH
From source instead: git clone https://github.com/EminUZUN/hoptell && cd hoptell && npm install && npm link.
Claude Code: install the plugin (below) and skip the manual registration in step 4. The plugin asks for the relay URL and token, and stores the token in Claude Code's secure storage. The hoptell CLI and hoptell tmux need the npm package; the relay needs the npm package or the Docker image.
Install the plugin. With automatic delivery, plain claude uses hooks when the startup check succeeds; add the channel flag to use channels:
/plugin marketplace add EminUZUN/hoptell
/plugin install hoptell@hoptell claude # hook notices claude --dangerously-load-development-channels plugin:hoptell@hoptell # channel notices
The relay image is ghcr.io/eminuzun/hoptell, and the server is listed in the MCP Registry as io.github.EminUZUN/hoptell.
mkdir -p ~/.config/hoptell
cat > ~/.config/hoptell/.env <<EOF HOPTELL_TOKEN=$(openssl rand -hex 32) HOPTELL_HOST=192.0.2.10 EOF chmod 600 ~/.config/hoptell/.env hoptell relay
Replace 192.0.2.10 with this machine's LAN or VPN address in the relay settings above. For Docker, use the same address and replace ... with your generated token: docker run -d -p 192.0.2.10:7777:7777 -v hoptell-state:/data -e HOPTELL_TOKEN=... ghcr.io/eminuzun/hoptell. Publish the port on that address only. Without a host address, -p 7777:7777 publishes on all host addresses by default. See examples/. Health check: GET /healthz.
The relay keeps a small state directory (~/.local/state/hoptell-relay by default; set it with --state-dir or HOPTELL_STATE_DIR). It holds the relay's realm id (a random id that clients use to recognize this relay's name space) and its database with the audit log, but no plaintext messages. Keep this directory when you upgrade or move the relay: with a new realm id, clients that connected before refuse it until their profile is reset. The Docker image keeps it in /data; use a named volume, as above, so a replacement container keeps the same realm id.
Add these settings to ~/.config/hoptell/.env (chmod 600). On the relay machine, add them to the file from step 2 and keep its HOPTELL_HOST and token:
HOPTELL_RELAY=ws://192.0.2.10:7777
HOPTELL_TOKEN=
Check: hoptell list should connect and print the peers (none yet).
Claude Code with the plugin (from step 1): start claude. Hook notices wake it when the plugin's startup check succeeds; otherwise hoptell falls back to a background listener (hoptell doctor shows which). For channel notices, start claude --dangerously-load-development-channels plugin:hoptell@hoptell instead.
Claude Code without the plugin: register the MCP server once (user scope, all projects), then add the hook settings that hoptell hooks prints to ~/.claude/settings.json:
claude mcp add --scope user hoptell -- hoptell mcp
hoptell hooks HOPTELL_NAME=laptop-claude claude
Don't use both the plugin and claude mcp add in the same session.
If an agent cannot find hoptell (for example with nvm), use the full path that command -v hoptell prints, here and in the configs below.
Inside a clone of this repo, .mcp.json registers the server for you.
Codex: add to ~/.codex/config.toml:
[mcp_servers.hoptell]
command = "hoptell" args = ["mcp"] tool_timeout_sec = 1800 # wait_for_message can block up to 1500s default_tools_approval_mode = "approve" # optional: no approval prompt per hoptell tool call
Then start Codex through tmux so messages wake it:
hoptell tmux laptop-codex -- codex
The launcher passes the peer name to Codex as a -c override, because interactive Codex starts MCP servers from a shared daemon that does not inherit your shell's environment. Detach with Ctrl-b d, reattach with tmux attach -t '=hoptell-laptop-codex'.
Antigravity (`agy`): register the MCP server once:
agy mcp add hoptell hoptell mcp
HOPTELL_NAME=laptop-agy agy # listener mode, after your first prompt hoptell tmux laptop-agy --roles gemini -- agy # or: woken through tmux
Ask either agent: *"list hoptell peers and say hi to laptop-codex"*.
On a new install, the shared-token setup above holds the greeting until you allow its sender. On the receiving machine, run hoptell contacts, then hoptell contacts show for the waiting sender. Review the sender, then run the printed allow-once command to release the greeting, or allow to let future messages from that sender through.
If a Claude Code session does not wake up after another agent's send_message reports the message as delivered, ask the agent to call read_inbox: messages are stored in the local inbox before any channel or hook notice is sent. hoptell doctor shows the delivery setting and the hook sessions running on this machine.
Receipts. With a current relay, messages stay in the session's inbox until the agent acknowledges them. read_inbox and wait_for_message return a batch with a receipt; the agent passes it back as ack in its next call (or calls ack_messages) once it has handled the messages. Reading again without acknowledging returns the same batch, and a batch that is not acknowledged within 30 minutes (HOPTELL_LEASE_MINUTES) is shown again, marked as such. An acknowledgement records that the agent accepted the messages; it does not make the agent's later actions happen exactly once. For agents that cannot repeat a value reliably, set HOPTELL_RECEIPTS=off: reading then removes messages, as before. A session's inbox holds at most 1,000 messages or 50 MB; beyond that, new messages wait at the relay