customer-support-agent 0.1.0

Solo Founder OS agent #9 — triage user messages (signup-broken / forge-stuck / billing / love / spam / novel) → auto-draft replies → HITL queue.

customer-support-agent

Solo Founder OS agent #9 — triage user messages (signup-broken / forge-stuck / billing / love / spam / novel) → auto-draft replies → HITL queue.

Built by Alex Ji — 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

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):

{"source":"email","source_id":"abc123","sender":"[e-mail]","subject":"signup not working","body":"Verification email never arrived..."}
{"source":"producthunt","source_id":"ph_456","sender":"@bob","subject":"","body":"Love this!"}

customer-support-agent triage --inbox inbox.jsonl

One-shot classify

customer-support-agent classify "I never got the verification email"
# label=signup_broken confidence=0.55
# reasoning: keyword match: signup, verification, email

Check queue

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

pip install 'customer-support-agent[mcp]'

{
  "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

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

Agent	What it does
solo-founder-os	The shared base lib (cron · eval · reflexion · skill library · DGM-lite). Every other agent depends on it.
build-quality-agent	Pre-push Claude diff reviewer + local build runner — catches CI-killing changes before they ship.
customer-discovery-agent	Reddit pain-point scraper + Claude clustering for product validation.
funnel-analytics-agent	Daily founder brief + real-time PH-day alerts across 9 sources.
orallexa-marketing-agent	AI marketing agent — submit project once, get platform-native posts for X / Reddit / HN / Dev.to / 小红书 + 7 more. Powers vibexforge.com.
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	Monthly bill audit across 6 providers (Vercel / Anthropic / OpenPanel / HyperDX / Supabase / GitHub Actions) with dollar-tagged waste findings.
bilingual-content-sync-agent	EN ⇄ 中文 i18n diff + Claude translate + HITL apply. Batch API path @ 50% off.
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>.