TWILS(1)

💅 twils(1) — like, the Twilio SMS lister, bestie

okay so this is twils from the General Commands Manual, section 1, and it's genuinely one of my fave little tools — it goes and fetches your Twilio Message resources and just, like, tells you their SIDs. no drama. ✨

---

🌸 SYNOPSIS 🌸

twils [-c config-file] [-u account-sid] [-p auth-token] [-P]
      [-C curl-flag] [--from number] [--to number] [--minDate date]
      [--maxDate date] [--limit num] [--pageSize size] [--raw]
twils [-c config-file] [-u account-sid] [-p auth-token] [-P]
      [-C curl-flag] [--raw] SID

two whole forms, bestie. pick your fighter 🫶

---

🦋 DESCRIPTION 🦋

so twils hits up the Twilio REST API, grabs your Message resources, and prints their message SID's to standard output. that's the whole vibe. 💖

messages come back in reverse chronological order — newest first, obviously, main character energy 👑

and in that second form up there? you hand it the SID of one specific message and it goes and gets that one. iykyk 💅

---

✨ OPTIONS ✨

• -c — tells it which config file to use. lowkey important: this file is literally just a shell script that, when sourced, has to define the ACCOUNT_SID and AUTH_TOKEN shell variables with your corresponding Twilio credentials. if you don't pass -c, it assumes /etc/twilio.conf. no cap. 🎀
• -C — passes curlflag straight through to curl(1). yes bestie, you get to talk to curl directly, slay.
• --from — only show messages sent from the phone number you give (it must be in E.164 format) or a 5 or 6 digit short code. 📱
• --to — only show messages sent to the phone number you give (again, E.164 format) or a 5 or 6 digit short code. 📲
• --minDate — only messages sent on or after the date you give. the date has to be in the form YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ. ⏰
• --maxDate — only messages sent on or before the date you give, and again it must be YYYY-MM-DD or YYYY-MM-DDTHH:MM:SSZ. ⏳
• --limit — return at most num results. boundaries, we love them 💅
• -p — specify the authentication token, which overrides AUTH_TOKEN from the config file, if there is one. 🔑
• -P — reads the authentication token from the terminal. cute and secret, we respect that 🙈
• --pageSize — set the query page size. default is 1000. yes, one thousand, that's not a typo 🍓
• --raw — outputs the raw XML from each page of results instead of just the message SID's. for the girlies who want everything 🔥
• -u — specify the Account SID, overriding ACCOUNT_SID from the config file, if there is one. 🪪

---

💀 EXIT STATUS 💀

twils exits zero when everything's chill, or 1 if an error happens. 😭

and any errors coming back from the Twilio REST API get reported to standard error — so they're not gonna sneak into your pretty stdout, thank god.

---

🌈 SEE ALSO 🌈

curl(1), smslen(1), twirm(1), twiping(1), twilog(1). go read the whole family, they're all iconic 👑

---

👑 AUTHOR 👑

Archie L. Cobbs <archie.cobbs@gmail.com> — thank you for your service, king 🫶

---

okay that's the whole page, and fr fr the whole thing is Debian, dated Feb 27, 2020, TWILS(1) — so like, that's the version and the date, mwah, go list some messages bestie 💖✨🎀