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
NotificationListenerServiceto 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-clicommand 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.
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.”
- gate 1caught: the sender contains “mom”
- gate 2not reached
- gate 3not reached
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”.
pip install projectx-cli17 property tests (Hypothesis)
Show the numbers as a table
| # | App | Sender | Stopped at | Why | Verdict | SMS chars |
|---|---|---|---|---|---|---|
| 1 | Chat | Mom | gate 1, VIP sender | VIP sender: mom | urgent, SMS | 53 |
| 2 | Deals | gate 3, AI gate | Promotional email | not urgent, stays (illustrative) | none | |
| 3 | IT Support | gate 2, Keywords | Urgent keyword: urgent | urgent, SMS | 57 | |
| 4 | Team chat | Standup bot | gate 3, AI gate | Automated digest that can wait | not urgent, stays (illustrative) | none |
| 5 | Chat | Cousin | gate 3, AI gate | Family health news asking for a call | urgent, SMS (illustrative) | 80 |
| 6 | Community | Meetup group | gate 2, Keywords | Contains urgent keyword: important | urgent, SMS | 83 |
| 7 | Team chat | Priya | gate 3, AI gate | Review request with no deadline | not urgent, stays (illustrative) | none |
| 8 | Community | Study group | gate 3, AI gate | Casual group chat | not urgent, stays (illustrative) | none |