A ferramenta de linha de comando do tosstome

Última verificação 2026-10-28

A página do navegador basta para transferências avulsas. A ferramenta de linha de comando acrescenta uma caixa de entrada: um computador sempre pronto para receber, com um link fixo para o qual seu celular ou qualquer outro dispositivo pode enviar. Funciona em Linux, macOS e Windows com Node.js 22 ou mais recente.

tosstome listen

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

Mantém aberta a caixa de entrada deste computador e salva os arquivos recebidos em DIR (padrão ./tosstome-inbox). Mostra o link da caixa de entrada e um QR code. As mensagens de texto são exibidas no terminal e também salvas como arquivos .txt. As transferências tentam primeiro uma conexão WebRTC direta, então um celular na mesma rede envia por essa rede, e recorrem ao relay se necessário; cada transferência recebida mostra qual dos dois foi usado.

Opção	O que faz
`--dir DIR`	Pasta para os arquivos recebidos
`--new`	Substitui as chaves da caixa de entrada, e o link antigo deixa de funcionar
`--nearby`	Também aparece na lista Nesta rede dos navegadores da mesma rede; esses arquivos vão para `DIR/nearby`
`--json`	Mostra um evento JSON por linha em vez de uma saída legível
`--server URL`	Usa um servidor próprio em vez do toss2.me

tosstome url

tosstome url

Mostra o link da caixa de entrada deste computador sem iniciá-la.

tosstome send

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

Envia arquivos, uma mensagem de texto ou os dois para o link de uma caixa de entrada. --text - lê a mensagem da entrada padrão. Coloque o link entre aspas no shell, porque ele contém #.

tosstome mcp

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

Executa como um servidor MCP via stdio, para que agentes de programação como o Claude Code ou o Cursor possam receber arquivos e texto do seu celular e enviá-los de volta. A caixa de entrada é iniciada na primeira vez que o agente a usa. Veja como enviar arquivos para um agente de IA.

Onde ficam as chaves

As chaves da caixa de entrada ficam em ~/.config/tosstome/inbox.json. A chave de envio faz parte do link; a chave do agente nunca sai desse arquivo. O servidor guarda apenas hashes das duas.

Ideias

Fotos do celular direto para uma pasta que seu gerenciador de fotos monitora.
Digitalizações e recibos do celular para uma pasta de arquivo de documentos, como a do paperless.
Capturas de tela do celular direto para o seu agente de programação, com tosstome mcp.
Artefatos de build de um job de CI para uma máquina de testes, com tosstome send.
Um aviso para outro computador quando uma tarefa longa terminar: make; tosstome send --text "build done" --to "INBOX_LINK".
Um Raspberry Pi que aceita arquivos de todos em casa com --nearby. Veja celular para servidor.

Perguntas

Funciona no Windows?

Sim. É um programa Node.js e roda em qualquer lugar onde o Node.js 22 ou mais recente rode, incluindo Windows, macOS e Linux.

Posso hospedar o servidor por conta própria?

Sim. O servidor é de código aberto e roda no Cloudflare Workers ou, com o mesmo código, como uma imagem Docker. Aponte a CLI para ele com --server.

Os arquivos recebidos sobrescrevem os existentes?

Os arquivos são gravados como .part enquanto chegam e renomeados quando completos. Os nomes de arquivo vindos de quem envia são reduzidos a um nome simples dentro da pasta de destino, então quem envia não consegue gravar fora dela.

Relacionados

Experimente agora

Abra o toss2.me em dois dispositivos. Sem app, sem conta e sem guardar nada.

Enviar um arquivo agora