wbot

wbot is an Agent-first, read-only interface to authorized WeChat conversations. This public repository owns the single wbot command, its MCP runtime, and the Codex and Claude Code plugins. The private Switchboard backend remains outside this repository.

Install

Install Bun, then install the latest verified GitHub Release artifact:

bun add --global "@celados/wbot@https://github.com/celados/wbot/releases/latest/download/wbot.tgz"
wbot auth set
wbot @schema

For internal dogfood against the test deployment, explicitly select its HTTP Actions origin:

WBOT_PLATFORM_URL=https://wbot-api-test.celados.com \
  wbot conversations.list '{ "limit": 50 }'

See the package README for CLI, MCP, credential, and cursor semantics, and the package changelog for release and migration notes.

Conversation results expose the Tenant's read and send capabilities. Conversation and message update results also expose capture freshness, allowing Agents to distinguish quiet conversations from delayed, unavailable, or insufficient capture evidence without accessing private operator diagnostics.

Public endpoints

The Agent CLI and MCP use the production HTTP Actions origin https://wbot-api-prod.celados.com. https://wbot-cloud-prod.celados.com is the separate Convex API/WebSocket origin for browser clients and is not a CLI or MCP base URL. Internal test dogfood explicitly sets WBOT_PLATFORM_URL to https://wbot-api-test.celados.com; no test-specific command is published.

Development

bun install --frozen-lockfile
bun run check
bun run test
bun run verify:package

Changing packages/wbot/package.json version on main creates an immutable tag and public GitHub Release after all gates pass.