Skip to content

Sketchbook / case study · see it on its sheet

ProjectX

Texts only the truly urgent messages to a keypad phone, so the smartphone can stay in the bag.

Dates
Jan 2026
Event
Dynamous × Kiro hackathon
Team
solo
My part
Solo: FastAPI backend, Kotlin Android listener, 3-stage classifier, PyPI CLI
Stack
Python · FastAPI · PostgreSQL · Kotlin · Twilio · Typer · Hypothesis
Verified
17 property-based tests18 days solo build160 characters SMS limit
Result
no result recorded

The problem

I wanted to carry only a keypad phone to the office without missing anything urgent from college, family or Discord. WhatsApp and similar apps have no API for personal messages, and the office machines blocked my personal email.

How it works

  • Capture without APIs. A native Kotlin Android app uses NotificationListenerService to read notifications from any messaging app and sync them to the backend.
  • Email too. A FastAPI and PostgreSQL backend polls Gmail over OAuth.
  • Three-stage triage. VIP senders first, then keywords, then an LLM (GPT-4o-mini via OpenRouter) for everything ambiguous. The first two stages are instant; the AI stage takes about ~2 s(self-reported).
  • SMS out. Urgent items go to the keypad phone through Twilio, cut to 160 characters.
  • Control from anywhere. A web dashboard, an authenticated API, and a pip install projectx-cli command line so I could check it from a locked-down work machine.

Decisions

  • Cheap rules first, the model last. Most messages never need the LLM.
  • Property tests on the classifier. 17 Hypothesis property tests guard the routing logic.

My part

All of it, solo, over 18 days for the Dynamous × Kiro hackathon in January 2026.

ProjectX: three gates to a keypad phone
The three gates8 notifications in. Gate 1, VIP sender, caught 1. Gate 2, keywords, caught 2. 5 reached gate 3, the AI gate; with illustrative verdicts 1 would be forwarded. 4 stay on the smartphone.8 notifications in1VIP senderinstantsender contains a VIPSelected message stopped here1 to SMS2Keywordsinstanttext contains a keyword2 to SMS3AI gate~2 sGPT-4o-mini, not run here1 to SMS4 stay on the smartphone

Gates 1 and 2 are the original's rules, run here exactly. Gate 3 is not run in your browser: its time (~2 s) is self-reported and its verdicts here are illustrative presets.

Selected · Chat · Mom

“Are you eating properly? Call me tonight.”

  1. gate 1caught: the sender contains “mom”
  2. gate 2not reached
  3. gate 3not reached
Urgent · SMS sent
ProjectXSMS 1/4
CHAT: Mom - Are you eating properly? Call me tonight.
53/160 chars

the keypad phone in the pocket

Incoming · 8 notifications · pick one to trace it

“AI:” marks an illustrative verdict

Gate 1 · VIP senders

Caught when the sender contains one of these, ignoring case.

Gate 2 · Keywords

Caught when the text contains one, ignoring case. Like the original it is a substring match, not a whole word, so “important” also catches “unimportant”.

Send your own notification

Gates 1 and 2 route it instantly. If it reaches the AI gate, nothing is sent here.

Would stop at: type something to see the route.

CLI on PyPIpip install projectx-cli

17 property tests (Hypothesis)

Simulation using recorded numbers from the ProjectX repo (classifier and SMS formatter)
Show the numbers as a table
VIP senders: mom, dad. Keywords: urgent, asap, deadline, emergency, important. SMS limit 160 characters. Gate 3 verdicts are illustrative, not model output.
#AppSenderStopped atWhyVerdictSMS chars
1ChatMomgate 1, VIP senderVIP sender: momurgent, SMS53
2EmailDealsgate 3, AI gatePromotional emailnot urgent, stays (illustrative)none
3EmailIT Supportgate 2, KeywordsUrgent keyword: urgenturgent, SMS57
4Team chatStandup botgate 3, AI gateAutomated digest that can waitnot urgent, stays (illustrative)none
5ChatCousingate 3, AI gateFamily health news asking for a callurgent, SMS (illustrative)80
6CommunityMeetup groupgate 2, KeywordsContains urgent keyword: importanturgent, SMS83
7Team chatPriyagate 3, AI gateReview request with no deadlinenot urgent, stays (illustrative)none
8CommunityStudy groupgate 3, AI gateCasual group chatnot urgent, stays (illustrative)none