wbot

wbot is an Agent-first interface to authorized WeChat conversations, with reading and text sending in the CLI and read-only MCP tools. 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.

Web viewer (test): wbot-web-test.celados.com.

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.

The CLI also supports wbot messages.send and wbot outbound-sends.get. See text sending for caller-owned idempotency and send-result semantics. MCP and Plugin tools remain read-only.

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.

Daily digest integration

integrations/digest contains the daily group-chat digest integration scaffold. It uses an independent Convex project and deployment, and accesses Switchboard through the public Platform HTTP interface. Its code is maintained in this workspace and is excluded from the CLI release artifact. Digest generation, scheduling, and sending are not implemented yet.

After configuring integrations/digest/.env.local, start development from the repository root:

bun run digest:dev