Content
# customer-support-agent
> Solo Founder OS agent #9 — triage user messages (signup-broken / forge-stuck / billing / love / spam / novel) → auto-draft replies → HITL queue.
[](LICENSE)
[](#)
Built by [Alex Ji](https://github.com/alex-jb) — closes the 5th layer of the canonical one-person-company stack (customer support).
## What it does
PH-day or post-launch, your inbox/PH-comments/X-DMs flood with user inquiries. This agent:
1. Reads incoming messages (JSONL inbox file)
2. Classifies each into one of 6 templates via Claude Haiku (or keyword fallback)
3. Drafts a reply for each non-spam classification
4. Writes drafts to `~/.customer-support-agent/queue/pending/` for HITL review
```
$ customer-support-agent triage --inbox messages.jsonl
# Customer support triage — 2026-05-02T13:24:00Z
Messages processed: 14
By label: {'signup_broken': 4, 'love': 5, 'billing': 2, 'forge_stuck': 1, 'spam': 1, 'novel': 1}
Drafts queued: 13
Spam skipped: 1
Novel (need human reply): 1
```
## Install
```bash
pip install customer-support-agent
# or
git clone https://github.com/alex-jb/customer-support-agent
cd customer-support-agent && pip install -e .
```
## Usage
### Triage a batch
Inbox JSONL format (one message per line):
```jsonl
{"source":"email","source_id":"abc123","sender":"alice@x.com","subject":"signup not working","body":"Verification email never arrived..."}
{"source":"producthunt","source_id":"ph_456","sender":"@bob","subject":"","body":"Love this!"}
```
```bash
customer-support-agent triage --inbox inbox.jsonl
```
### One-shot classify
```bash
customer-support-agent classify "I never got the verification email"
# label=signup_broken confidence=0.55
# reasoning: keyword match: signup, verification, email
```
### Check queue
```bash
customer-support-agent queue-status
# # Pending drafts (3)
# - 2026-05-02-signup_broken-alice-x-com.md
# - 2026-05-02-billing-bob-x-com.md
# - 2026-05-02-novel-carol-x-com.md
```
## Six default labels
| Label | Trigger | Action |
|---|---|---|
| `signup_broken` | auth/login/register problems | empathetic + 2-3 troubleshooting steps |
| `forge_stuck` | core flow stuck/broken | "this is on me, fixing now" |
| `billing` | payment/refund/subscription | acknowledge + 24h response promise |
| `love` | positive feedback | brief thank-you |
| `spam` | promo/scam/irrelevant | skipped |
| `novel` | doesn't match any | "I'll think on this" placeholder + flag for human |
## Why all drafts go to HITL
Auto-sending replies to real users is the fastest way to get banned, mocked, or to send something tone-deaf. This agent NEVER sends. It drafts; you review in Obsidian; you send (or paste into Gmail / PH / X).
## MCP server
```bash
pip install 'customer-support-agent[mcp]'
```
```json
{
"mcpServers": {
"customer-support": {
"command": "customer-support-mcp",
"env": { "ANTHROPIC_API_KEY": "..." }
}
}
}
```
Tools: `classify_message(text, subject?, sender?)` · `draft_support_reply(text, subject?, sender?, label?)`
## Roadmap
- [x] **v0.1** — heuristic + Claude classifier · 6 labels · HITL queue · MCP server · 25 tests
- [ ] **v0.2** — IMAP + PH GraphQL ingest (auto-pull instead of JSONL)
- [ ] **v0.3** — auto-send "love" replies (still HITL on first 100, then auto)
- [ ] **v0.4** — Reflexion learning: classifier improves from rejected drafts
## License
MIT.
---
## 🧩 Part of the [Solo Founder OS](https://github.com/alex-jb/solo-founder-os) stack
A growing collection of MIT-licensed agents that share `solo-founder-os` as their base — cron, eval, reflexion, AnthropicClient, HITL queue, notifiers. Each agent is independently useful; together they cover the full one-person company workflow.
🌐 The whole stack is live in production at [vibexforge.com](https://vibexforge.com).
| Agent | What it does |
|---|---|
| [solo-founder-os](https://github.com/alex-jb/solo-founder-os) | The shared base lib (cron · eval · reflexion · skill library · DGM-lite). Every other agent depends on it. |
| [build-quality-agent](https://github.com/alex-jb/build-quality-agent) | Pre-push Claude diff reviewer + local build runner — catches CI-killing changes before they ship. |
| [customer-discovery-agent](https://github.com/alex-jb/customer-discovery-agent) | Reddit pain-point scraper + Claude clustering for product validation. |
| [funnel-analytics-agent](https://github.com/alex-jb/funnel-analytics-agent) | Daily founder brief + real-time PH-day alerts across 9 sources. |
| [orallexa-marketing-agent](https://github.com/alex-jb/orallexa-marketing-agent) | AI marketing agent — submit project once, get platform-native posts for X / Reddit / HN / Dev.to / 小红书 + 7 more. Powers [vibexforge.com](https://vibexforge.com). |
| [vc-outreach-agent](https://github.com/alex-jb/vc-outreach-agent) | Cold email drafter — investors (vc mode) or paying customers (customer mode, merged from customer-outreach in v0.9.0). HITL queue + SMTP sender. |
| [cost-audit-agent](https://github.com/alex-jb/cost-audit-agent) | Monthly bill audit across 6 providers (Vercel / Anthropic / OpenPanel / HyperDX / Supabase / GitHub Actions) with dollar-tagged waste findings. |
| [bilingual-content-sync-agent](https://github.com/alex-jb/bilingual-content-sync-agent) | EN ⇄ 中文 i18n diff + Claude translate + HITL apply. Batch API path @ 50% off. |
| [payments-agent](https://github.com/alex-jb/payments-agent) | Overdue-invoice reminder drafter. Stripe-shaped types + MockProvider fallback + hard money-safety prompt rules. |
*Each agent's own row is omitted from its README. Install whichever solve real problems for you — `pip install <agent-name>`.*
