pidgesms — SMS via pidge

Send and read SMS messages via pidge, a CLI for Android SMS Gateway. The gateway runs on an Android device and pidge connects to it automatically.

pidge reads its config from ~/.config/pidge/config.toml — no env vars needed.

Send SMS

pidge send "+1XXXXXXXXXX" "Your message here"

• Phone numbers must be E.164 format (e.g. +15551234567)
• Response includes id and state (Pending → Processed → Sent → Delivered)

Check delivery status

pidge status <message-id>

Read SMS (inbox)

pidge inbox
pidge inbox --unread
pidge inbox --json

Mark message as processed / unprocessed

pidge ack <id>      # mark as processed
pidge unack <id>    # mark as unprocessed

Health check

pidge health

Safety rules

• Messages are sent to real phone numbers. Always confirm the recipient and content before sending.
• NEVER send SMS to unknown numbers without explicit owner approval.
• NEVER send bulk or repeated messages.
• NEVER send sensitive information (passwords, API keys, tokens, etc.) via SMS.
• NEVER include the full content of private SMS messages in group chat responses.
• When showing credentials, prefer a summary — only reveal full message content if directly requested in a private context.