paw-mail-usage

Paw Mail CLI

CLI は paw-mail-cli リポジトリからビルド済みバイナリとして配布されています。使用する前にインストールする必要があります。

インストール

# Nix (recommended)
nix profile install 'github:pawpair/paw-mail-cli?dir=nix#paw-mail'

# Homebrew (macOS / Linux)
brew tap pawpair/paw-mail-cli && brew install paw-mail

# Arch Linux (AUR)
yay -S paw-mail-bin

# Debian / Ubuntu — download .deb from latest release
# https://github.com/pawpair/paw-mail-cli/releases/latest
sudo dpkg -i paw-mail_*_amd64.deb

バイナリ

バイナリ	説明
paw-mail	統合 CLI + TUI（推奨）
paw-mail-tui	ターミナルユーザーインターフェースのみ

以下のすべての例では paw-mail を使用します。TUI は paw-mail-tui または paw-mail tui で起動できます。

グローバルフラグ

これらのフラグはサブコマンドの前に指定します。

フラグ	環境変数	説明
--server <url>	MAIL_SERVER	gRPC バックエンドアドレス
--format <table|json>	—	出力形式（デフォルト：table）
--auth-backend <auto|keyring|file>	MAIL_AUTH_BACKEND	トークンストレージのバックエンド
-v, --verbose	—	デバッグログを有効にする

サブコマンド

設定

paw-mail config refresh  # Fetch remote config and cache locally
paw-mail config show     # Show current config values

設定はローカルの ~/.local/pawpair/config.json（または ~/.pawpair/config.json）にキャッシュされます。初回実行時は、リモート設定サービスから自動的に初期設定されます。

認証

paw-mail auth login      # OAuth device flow login
paw-mail auth status     # Show auth state + backend
paw-mail auth logout     # Clear stored tokens

アカウント

paw-mail accounts list
paw-mail accounts get --provider <google|microsoft>
paw-mail accounts add --email <e> --provider <google|microsoft>  # Opens browser for OAuth
paw-mail accounts delete --provider <google|microsoft>
paw-mail accounts activate --id <uuid>
paw-mail accounts deactivate --id <uuid>
paw-mail accounts oauth-clients            # List user OAuth clients
paw-mail accounts oauth-clients --system   # List system OAuth clients

メール

paw-mail emails folders --provider <p> --email <e>
paw-mail emails list --provider <p> --email <e> --folder INBOX [--limit 50]
paw-mail emails fetch --provider <p> --email <e> --folder INBOX --uid <n>
paw-mail emails body --provider <p> --email <e> --folder INBOX --uid <n>
paw-mail emails search --provider <p> --email <e> --folder INBOX --query <q>
paw-mail emails read --provider <p> --email <e> --folder INBOX --uid <n>
paw-mail emails unread --provider <p> --email <e> --folder INBOX --uid <n>
paw-mail emails flag --provider <p> --email <e> --folder INBOX --uid <n> [--unflag]
paw-mail emails move --provider <p> --email <e> --folder INBOX --uid <n> --destination Trash
paw-mail emails delete --provider <p> --email <e> --folder INBOX --uid <n>

同期

paw-mail sync status --account-id <id>
paw-mail sync trigger --account-id <id>
paw-mail sync history --account-id <id>

スレッド

paw-mail threads list --account-id <id>
paw-mail threads get --thread-id <id> --account-id <id>

認証バックエンド

# Auto-detect (default) — tries keyring, falls back to file
paw-mail auth status

# Force file-based storage
paw-mail --auth-backend file auth status

# Force keyring (errors if unavailable)
paw-mail --auth-backend keyring auth status

# Verbose to see backend selection
paw-mail -v auth status

よくある問題

• command not found: paw-mail — CLI がインストールされていません。上記の「インストール」を参照してください。
• Keyring write failed: locked collection — GNOME Keyring がロックされています。--auth-backend file を使用するか、キーリングのロックを解除してください。
• Could not open browser — ヘッドレスまたは SSH セッションです。表示された URL を手動でコピーしてください。