La herramienta de línea de comandos de tosstome

Última revisión 2026-10-28

La página del navegador basta para transferencias puntuales. La herramienta de línea de comandos añade un buzón: una computadora que siempre está lista para recibir, con un enlace fijo al que tu teléfono o cualquier otro dispositivo puede enviar. Funciona en Linux, macOS y Windows con Node.js 22 o posterior.

tosstome listen

tosstome listen [--dir DIR] [--new] [--nearby] [--json] [--server URL]

Mantiene abierto el buzón de esta computadora y guarda los archivos entrantes en DIR (por defecto ./tosstome-inbox). Muestra el enlace del buzón y un código QR. Los mensajes de texto se muestran en la terminal y también se guardan como archivos .txt. Las transferencias prueban primero una conexión WebRTC directa, de modo que un teléfono en la misma red envía por esa red, y recurren al relé si no es posible; cada transferencia entrante indica cuál usó.

Opción	Qué hace
`--dir DIR`	Carpeta para los archivos entrantes
`--new`	Reemplaza las claves del buzón, de modo que el enlace anterior deja de funcionar
`--nearby`	Aparece también en la lista “En esta red” de los navegadores de la misma red; esos archivos van a `DIR/nearby`
`--json`	Imprime un evento JSON por línea en lugar de una salida legible
`--server URL`	Usa un servidor propio en lugar de toss2.me

tosstome url

tosstome url

Muestra el enlace del buzón de esta computadora sin iniciar el buzón.

tosstome send

tosstome send [FILE...] [--text TEXT] --to LINK

Envía archivos, un mensaje de texto o ambos a un enlace de buzón. --text - lee el mensaje de la entrada estándar. Pon el enlace entre comillas en el shell, porque contiene #.

tosstome mcp

tosstome mcp [--dir DIR] [--server URL] [--nearby]

Se ejecuta como servidor MCP por stdio, de modo que agentes de programación como Claude Code o Cursor pueden recibir archivos y texto de tu teléfono y devolverlos. El buzón se inicia la primera vez que el agente lo usa. Consulta enviar archivos a un agente de IA.

Dónde se guardan las claves

Las claves del buzón se guardan en ~/.config/tosstome/inbox.json. La clave de envío forma parte del enlace; la clave de agente nunca sale de ese archivo. El servidor guarda solo los hashes de ambas.

Ideas de uso

Fotos del teléfono directamente a una carpeta que vigila tu gestor de fotos.
Escaneos y recibos del teléfono a una carpeta de tu archivo de documentos.
Capturas de pantalla del teléfono directamente a tu agente de programación, con tosstome mcp.
Artefactos de compilación de un trabajo de CI a una máquina de pruebas, con tosstome send.
Un aviso a otra computadora cuando termina una tarea larga: make; tosstome send --text "build done" --to "INBOX_LINK".
Una Raspberry Pi que acepta archivos de todos en casa con --nearby. Consulta teléfono a servidor.

Preguntas

¿Funciona en Windows?

Sí. Es un programa de Node.js y funciona en cualquier sistema donde corra Node.js 22 o posterior, incluidos Windows, macOS y Linux.

¿Puedo alojar el servidor por mi cuenta?

Sí. El servidor es de código abierto y funciona en Cloudflare Workers o, con el mismo código, como imagen de Docker. Apunta la CLI hacia él con --server.

¿Los archivos entrantes sobrescriben los existentes?

Los archivos se escriben como .part mientras llegan y se renombran al completarse. Los nombres de archivo que envía el remitente se reducen a un nombre simple dentro de la carpeta de destino, así que no se puede escribir fuera de ella.

Relacionado

Pruébalo ahora

Abre toss2.me en dos dispositivos. Sin app, sin cuenta y sin guardar nada.

Enviar un archivo ahora