Wacli – WhatsApp CLI: 동기화, 검색, 전송

whatsmeow 위에 만든 WhatsApp CLI로, 로컬에 메시지 기록을 best-effort 동기화하고 오프라인 검색, 메시지 전송, 연락처·그룹 관리를 지원한다.

• WhatsApp Web 프로토콜을 사용하며, WhatsApp과는 공식 제휴가 없다.
• 현재 core implementation이 구현돼 있고, 전체 설계는 docs/spec.md에 정리돼 있다.
• 0.2.0 업데이트에서는 검색/목록에 반응·답장·미디어 타입의 표시 텍스트가 추가됐고, 파일 전송 시 --filename으로 표시 이름을 덮어쓸 수 있으며, WACLI_DEVICE_LABEL과 WACLI_DEVICE_PLATFORM 환경변수로 링크된 기기 정보를 바꿀 수 있다.

설치 방식은 두 가지다.

• Homebrew tap: brew install steipete/tap/wacli
• 로컬 빌드: go build -tags sqlite_fts5 -o ./dist/wacli ./cmd/wacli

기본 저장 경로는 ~/.wacli이며, --store DIR로 변경할 수 있다. 로그인은 wacli auth로 QR 코드를 스캔해 초기 동기화를 수행하고, 이후에는 wacli sync --follow로 QR 없이 계속 동기화한다. 검색은 wacli messages search, 전송은 wacli send text와 wacli send file, 그룹 관리는 wacli groups list와 wacli groups rename으로 처리한다.

과거 메시지를 더 가져오려면 history backfill을 쓴다. 다만 이 기능은 best-effort라서 모든 기록이 보장되지 않고, primary device(휴대폰)가 온라인이어야 하며, 채팅별로 동작하고, 권장 --count는 50이다.

프로젝트는 최신 릴리스가 v0.6.0 (2026-04-14) 이고, HN에서 볼 만한 실사용형 오픈소스 CLI 도구에 해당한다.