Skip to content

Repository files navigation

Catalyst X

Human-in-the-loop X (Twitter) growth system for Catalyst. Draft → approve → publish → measure.

What it does

X search / monitor
       ↓
  AI analysis + drafts
       ↓
  You approve (yes/no)
       ↓
  Post / quote / thread
       ↓
  Measure + iterate
  • Approval queue — review seeded and generated drafts; yes schedules, no rejects
  • Opportunities — healthcare AI conversations worth engaging with
  • Schedule — week-one posting cadence (Mon insight, Tue engagement, Wed thread, etc.)
  • Analytics — impressions, engagement, approval rate
  • MCP tools — Cursor agents can list drafts, search X, and queue replies

Quick start

paas login
npm install
X_MOCK_MODE=true paas dev

Open the app, go to Approval queue, and start marking yes/no on drafts.

Connect X API (production)

  1. Create a project at developer.x.com (pay-per-use credits required as of 2026).
  2. Generate OAuth 1.0a user tokens with Read and Write scope.
  3. Store secrets in Catalyst (never commit):
paas secret set catalyst-x X_API_KEY --stdin
paas secret set catalyst-x X_API_SECRET --stdin
paas secret set catalyst-x X_ACCESS_TOKEN --stdin
paas secret set catalyst-x X_ACCESS_TOKEN_SECRET --stdin
# optional
paas secret set catalyst-x X_BEARER_TOKEN --stdin
  1. Request console grants:

    • store — persist drafts, schedule, metrics
    • Egressapi.x.com
    • Secret read — X API keys above
  2. Deploy:

paas deploy
paas permissions catalyst-x --mode domain

Unset X_MOCK_MODE in production.

MCP tools (catalyst-x-mcp)

Tool Purpose
list_pending_drafts Drafts awaiting approval
approve_draft / reject_draft Human-in-the-loop decisions
list_opportunities Engagement targets
draft_reply Turn opportunity into a draft
search_x Live X search
x_status Connection health

Local MCP surface:

CIPHER_MCP_SURFACE=1 X_MOCK_MODE=true npm start

Week-one content strategy

Day Slot Theme
Mon 8am ET Insight AI governance & hospital operations
Tue 12pm ET Engagement Quote/reply in healthcare AI conversations
Wed 8am ET Thread Patient engagement, care coordination, AI ROI
Thu 5pm ET Take Quick reaction to health system news
Fri 10am ET Builder Building in public — what we shipped/learned

First-run seeds four drafts aligned to this strategy so you can approve immediately.

Architecture

  • catalyst-x — primary web UI (Node + React/@cipher/ui)
  • catalyst-x-mcp — gateway MCP tools for Cursor agents
  • @cipher/store — draft queue, opportunities, schedule state
  • @cipher/secrets — X API credentials
  • Mock mode for local dev without API spend

License

Internal CipherHealth tooling. Public repo for transparency — do not commit secrets or PHI.

About

No description, website, or topics provided.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Used by

Contributors

Languages