tosstome 명령줄 도구
마지막 확인
한 번만 전송하는 거라면 브라우저 페이지로 충분해요. 명령줄 도구는 수신함을 더해 줘요. 항상 받을 준비가 되어 있고, 휴대폰이나 다른 기기가 보낼 수 있는 고정 링크가 있는 컴퓨터예요. Node.js 22 이상이 있으면 Linux, macOS, Windows에서 실행돼요.
tosstome listen
tosstome listen [--dir DIR] [--new] [--nearby] [--json] [--server URL]이 컴퓨터의 수신함을 열어 두고 받은 파일을 DIR(기본값 ./tosstome-inbox)에 저장해요. 수신함 링크와 QR 코드를 출력해요. 텍스트 메시지는 터미널에 출력되고 .txt 파일로도 저장돼요. 전송은 먼저 WebRTC 직접 연결을 시도해서, 같은 네트워크에 있는 휴대폰은 그 네트워크 안에서 보내고, 안 되면 릴레이로 전환해요. 받는 전송마다 어느 쪽을 썼는지 표시돼요.
| 옵션 | 동작 |
|---|---|
--dir DIR | 받는 파일을 저장할 폴더 |
--new | 수신함 키를 교체해서 예전 링크를 쓸 수 없게 해요 |
--nearby | 같은 네트워크에 있는 브라우저의 같은 네트워크 목록에도 나타나요. 이렇게 받은 파일은 DIR/nearby에 저장돼요 |
--json | 사람이 읽는 출력 대신 한 줄에 JSON 이벤트 하나를 출력해요 |
--server URL | toss2.me 대신 직접 호스팅한 서버를 써요 |
tosstome url
tosstome url수신함을 시작하지 않고 이 컴퓨터의 수신함 링크만 출력해요.
tosstome send
tosstome send [FILE...] [--text TEXT] --to LINK파일, 텍스트 메시지, 또는 둘 다를 수신함 링크로 보내요. --text -를 쓰면 표준 입력에서 메시지를 읽어요. 링크에는 #이 들어 있으니 셸에서 따옴표로 감싸세요.
tosstome mcp
tosstome mcp [--dir DIR] [--server URL] [--nearby]stdio 기반 MCP 서버로 실행돼서, Claude Code나 Cursor 같은 코딩 에이전트가 휴대폰에서 파일과 텍스트를 받고 다시 보낼 수 있어요. 수신함은 에이전트가 처음 사용할 때 시작돼요. AI 에이전트에 파일 보내기를 참고하세요.
키는 어디에 있나요
수신함 키는 ~/.config/tosstome/inbox.json에 저장돼요. 전송 키는 링크의 일부이고, 에이전트 키는 그 파일 밖으로 나가지 않아요. 서버는 두 키의 해시만 저장해요.
활용 아이디어
- 휴대폰 사진을 사진 관리 앱이 지켜보는 폴더로 바로 보내요.
- 휴대폰으로 찍은 스캔본과 영수증을 paperless 같은 문서 보관 폴더로 보내요.
tosstome mcp로 휴대폰의 스크린샷을 코딩 에이전트에 바로 보내요.tosstome send로 CI 작업의 빌드 결과물을 테스트 머신에 보내요.- 오래 걸리는 작업이 끝나면 다른 컴퓨터로 알림을 보내요:
make; tosstome send --text "build done" --to "INBOX_LINK". --nearby로 집에 있는 모든 사람에게서 파일을 받는 라즈베리 파이를 만들어요. 폰에서 서버로를 참고하세요.
자주 묻는 질문
Windows에서도 실행되나요?
네. Node.js 프로그램이라서 Windows, macOS, Linux를 포함해 Node.js 22 이상이 실행되는 곳이면 어디서든 돼요.
서버를 직접 호스팅할 수 있나요?
네. 서버는 오픈 소스이고 Cloudflare Workers에서 실행하거나, 같은 코드로 Docker 이미지로도 실행할 수 있어요. CLI에서 --server로 그 서버를 지정하세요.
받은 파일이 기존 파일을 덮어쓰나요?
파일은 도착하는 동안 .part로 쓰이다가 완료되면 이름이 바뀌어요. 보내는 쪽이 정한 파일 이름은 대상 폴더 안의 단순한 이름으로 정리되므로, 보내는 쪽이 폴더 밖에 쓸 수 없어요.