본문으로 건너뛰기

remocon CLI로 명령 보내기

remocon은 IOSignal 서버에 메시지를 보내는 CLI입니다. 셸 스크립트에서 한 번 보내고 끝내거나, 터미널의 줄·키 입력을 그대로 보내 장치를 조작할 때 씁니다. 서버 실행과 대화형 디버깅은 iosignal-cli를 쓰세요. 두 CLI는 같은 저장소(iosignal-cli의 packages/remocon)에서 함께 릴리스합니다.

설치​

Node.js 22.16.0 이상이 필요합니다.

npm install -g remocon

remocon과 remote 두 명령이 설치됩니다.

연결 옵션​

기본 서버는 wss://io.remocon.kr/ws입니다. 공통 옵션은 하위 명령 앞에 씁니다.

remocon -c ws://localhost:7777 pub demo hello
remocon -c cong://localhost:8888 input demo --keys
remocon -c ws://localhost:7777 -i uno -k uno-key console
옵션설명
-c, --connect <url>ws://, wss:// 또는 cong://. host:port만 쓰면 WebSocket
-i, --id <id> / -k, --key <key>인증 ID와 키, 함께 지정
-a, --auth-idKey <id.key>인증 정보 단축 표기. -i/-k 쌍이 우선
-j, --join-channel <tags>시작할 때 구독, 쉼표로 구분
-t, --timeout <ms>연결, 종료 확인, 서비스 응답 제한 시간. 기본 10000ms
-h, --help / -V, --version도움말 / 버전

명령행의 키는 셸 기록이나 프로세스 목록에 남을 수 있습니다.

한 번 보내기​

remocon pub demo hello world # payload 두 개: hello, world
remocon pub demo "hello world" # payload 하나
remocon call reply echo hello # 서버 서비스 호출, 응답 출력
remote demo hello # 예전 문법 그대로

pub, publish, sig, signal은 같은 동작입니다. 연결이 ready가 된 뒤 보내고, 끝내기 전에 서버 echo로 앞선 메시지를 서버가 받았는지 확인합니다. 이 확인은 받는 장치가 처리했다는 뜻이 아닙니다. 장치 처리를 확인하려면 장치의 $state 같은 응답을 구독하세요.

장치 하나에 명령을 보낼 때는 그 장치의 CID 뒤에 @를 붙여 직접 보냅니다(장치는 @로 받습니다).

remocon pub "?k3vd@" toggle # 익명 장치 ?k3vd에 toggle 명령

줄 단위 입력​

remocon input demo # --lines가 기본
printf 'first\nsecond\n' | remocon input demo

Enter마다 한 줄 전체를 문자열 하나로 보냅니다. 앞뒤 공백, 빈 줄, 따옴표를 그대로 둡니다. 파이프 입력은 끝까지 보낸 뒤 종료합니다.

키 단위 입력​

remocon input demo --keys

TTY 터미널에서 키를 누를 때마다 바로 보냅니다. 문자는 그 글자(a, 한), 특수 키는 이름(up, down, enter, ctrl+a, f1)입니다. Ctrl+C는 보내지 않고 종료합니다. 운영체제 전역 키보드가 아니라 현재 터미널의 입력이며, 키를 떼는 이벤트는 없습니다. 받는 쪽에서는 up이라는 글자와 방향키 이름이 같은 문자열입니다.

대화형 명령​

인자 없이 remocon(또는 remocon console)을 실행하면 대화형 명령이 시작됩니다. 명령은 iosignal-cli와 같고(sub, pub, call, id, ping 등, 앞에 점 없음), 따옴표로 공백이 든 인자를 묶을 수 있습니다. input <tag>로 줄 입력 모드에 들어가 .back으로 돌아옵니다. 전체 목록은 help로 봅니다.

  • ping은 서버 ping입니다. 9.19.0부터 상대 CID로 보내는 ping <cid>는 없습니다.
  • 접속할 때마다 iam('remocon-cli')로 연결 이름을 알립니다.