# ProjectX

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

- Dates: Jan 2026 · Dynamous × Kiro hackathon
- Team: solo
- My part: Solo: FastAPI backend, Kotlin Android listener, 3-stage classifier, PyPI CLI
- Verified: 17 property-based tests; 18 days solo build; 160 characters SMS limit
- Result: no result recorded
- Case study: https://solaimuthu.vercel.app/work/projectx

### 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.
