WhatsAppをターミナルから操作！メッセージの同期・検索・送信をコマンド一発で — wacli

アーキテクチャ・仕組み

• whatsmeow ライブラリを基盤としており、WhatsApp Webプロトコルを利用してメッセージの送受信・同期を行う
• Go言語で実装されており、SQLite（FTS5拡張付き）をローカルストレージとして使用
• WhatsApp公式とは無関係のサードパーティツール

主要な機能一覧

• 認証（auth）: QRコード表示によるインタラクティブログイン + 初期データ同期
• 同期（sync）: 非インタラクティブな同期ループ（--follow で継続実行）
• メッセージ検索: オフラインでのフルテキスト検索（SQLite FTS5使用）
• メッセージ送信: テキスト送信、ファイル送信（キャプション付き、表示ファイル名のオーバーライド対応）
• メディアダウンロード: 同期済みメッセージのメディアファイルをダウンロード
• グループ管理: グループ一覧、リネーム、参加者管理
• 履歴バックフィル: チャットごとに古いメッセージの取得リクエストを送信（ベストエフォート）
• 診断（doctor）: 動作状況の確認
• リアクション・返信・メディアタイプの表示テキスト対応（v0.2.0）

出力形式

• デフォルトは人間が読みやすいテキスト形式
• --json フラグで機械可読なJSON形式に切り替え可能（スクリプトやパイプラインとの連携に便利）

ストレージ

• デフォルトのデータ保存先: ~/.wacli
• --store DIR オプションで変更可能

環境変数による設定

履歴バックフィルの制約・注意点

• ベストエフォート方式: WhatsAppが完全な履歴を返す保証はない
• プライマリデバイス（スマートフォン）がオンラインである必要がある
• リクエストはチャット単位（DM/グループごと）で行う
• ローカルに保存された最も古いメッセージを基準点として使用
• 推奨設定: --count 50（1リクエストあたり50件）
• 全チャット一括バックフィルはシェルスクリプトで jq と組み合わせて実現可能

対応環境

• Go言語のビルド環境、またはHomebrewが使えるmacOS
• ビルド時に sqlite_fts5 タグが必要

先行プロジェクト

• Vicente Reig氏の whatsapp-cli にインスパイアされている

ライセンス

• リポジトリ内の LICENSE ファイルを参照（README上では種別の明記なし）

方法A: Homebrewでインストール（macOS）

brew install steipete/tap/wacli

方法B: ソースからビルド（Go言語が必要）

go build -tags sqlite_fts5 -o ./dist/wacli ./cmd/wacli
./dist/wacli --help

クイックスタート

# 1) 認証（QRコードが表示される）→ 初期同期
wacli auth

# 2) 継続的に同期
wacli sync --follow

# メッセージ検索
wacli messages search "meeting"

# テキスト送信
wacli send text --to 1234567890 --message "hello"

# ファイル送信
wacli send file --to 1234567890 --file ./pic.jpg --caption "hi"