pidgesms
by typhonius
CommunicationBrief
Send and read SMS text messages via an Android phone using pidge.
Description
What This Skill Does
Sends and reads SMS messages from the command line using pidge, a CLI that connects to Android SMS Gateway running on an Android device. Phone numbers must be in E.164 format. Config lives in ~/.config/pidge/config.toml with no environment variables required.
Uses an Android phone you already own as the SMS backend instead of requiring a paid SMS API subscription.
When to Use It
- Send a text to a contact without touching a phone
- Check unread SMS from a terminal or script
- Get notified via text when a long-running job finishes
- Reply to an incoming message from the command line
- Confirm delivery status of a sent text
Example Workflow
User asks: Send a text to +15551234567 saying 'Package delivered'
- 1
Run: pidge send "+15551234567" "Package delivered"
- 2
Capture the message id from the response
- 3
Run: pidge status <message-id> to check delivery state
- 4
Confirm state has progressed to Delivered
Message sent and confirmed as Delivered
Requirements
- Android device with Android SMS Gateway app installed and running
- pidge CLI binary (go install github.com/typhonius/pidge@latest)
Installation
clawhub install typhonius/pidgesmsRun the CLI command, or paste the prompt into Claude Code, Cursor, Codex or whichever coding agent you use.