How unlinearity/cli-wechat-bridge works
CLI WeChat Bridge connects WeChat or WeCom to locally running Codex, Claude Code, OpenCode, and Pi sessions, keeping the local CLI as the primary workspace. The main flow is remote message → channel transport → bridge routing and adapter → local CLI → output relayed to the channel; a daemon can manage multiple CLI sessions. Setup, approval/input handling, attachments, session resumption, and health checks are additional capabilities. Relationships are limited to README statements and shown source references/calls; several major subsystems are represented by their exact source paths, though their internals were not sampled.
Main entry points: bridge-adapters.ts Adapter selection · wechat-transport.ts WeChat channel · wecom-transport.ts WeCom channel · wechat-daemon.ts Multi-CLI daemon
Components 24
Remote channels
- WeChat channel
src/wechat/wechat-transport.ts - WeCom channel
src/channels/wecom/wecom-transport.ts - Channel drivers
src/channels/channel-driver-factory.ts - WeChat forwarding
src/channels/wechat/wechat-forwarding.ts
Bridge runtime
- Channel contracts
src/core/channel-types.ts - Multi-CLI daemon
src/daemon/wechat-daemon.ts - Message router
src/core/bridge-message-router.ts - Turn coordination
src/core/turn-coordinator.ts - Bridge orchestration
src/bridge/wechat-bridge.ts
CLI adapters
- Adapter selection
src/bridge/bridge-adapters.ts - Codex adapter
src/bridge/bridge-adapters.codex.ts - Claude adapter
src/bridge/bridge-adapters.claude.ts - OpenCode adapter
src/bridge/bridge-adapters.opencode.ts - Pi adapter
src/bridge/bridge-adapters.pi.ts - Adapter support
src/bridge/bridge-adapters.shared.ts - Visible CLI companion
src/companion/local-companion.ts
Setup and state
- Companion endpoints
src/companion/local-companion-link.ts - Bridge state
src/bridge/bridge-state.ts - Channel setup and config
src/wechat/channel-config.ts - WeChat setup
src/wechat/setup.ts - WeCom setup
src/channels/wecom/setup.ts - Environment doctor
src/utils/doctor.ts
Other components
- Remote user
- Local CLI user
Connections 28
- Remote user → WeChat channel: sends messages
README.md - Remote user → WeCom channel: sends messages
README.md - WeChat channel → Channel drivers: provides channel
src/channels/channel-driver-factory.ts - WeCom channel → Channel drivers: provides channel
src/channels/channel-driver-factory.ts - Channel drivers → Channel contracts: uses contracts
src/channels/channel-driver-factory.ts - WeChat forwarding → WeChat channel: sends replies
src/channels/wechat/wechat-forwarding.ts - Multi-CLI daemon → Message router: routes messages
src/daemon/wechat-daemon.ts - Message router → Channel contracts: uses contracts
src/core/bridge-message-router.ts - Turn coordination → Channel contracts: uses contracts
src/core/turn-coordinator.ts - Multi-CLI daemon → Adapter selection: selects adapter
src/daemon/wechat-daemon.ts - Adapter selection → Codex adapter: dispatches
src/bridge/bridge-adapters.ts - Adapter selection → Claude adapter: dispatches
src/bridge/bridge-adapters.ts - Adapter selection → OpenCode adapter: dispatches
src/bridge/bridge-adapters.ts - Adapter selection → Pi adapter: dispatches
src/bridge/bridge-adapters.ts - Codex adapter → Adapter support: uses helpers
src/bridge/bridge-adapters.ts - Claude adapter → Local CLI user: runs locally
README.md - Codex adapter → Local CLI user: runs locally
README.md - OpenCode adapter → Local CLI user: runs locally
README.md - Pi adapter → Local CLI user: runs locally
README.md - Local CLI user → Visible CLI companion: uses visible terminal
README.md - Visible CLI companion → Companion endpoints: publishes endpoint
- Channel setup and config → Companion endpoints: locates endpoint
src/companion/local-companion-link.ts - WeChat setup → Channel setup and config: configures channel
src/wechat/setup.ts - WeCom setup → WeCom channel: configures channel
README.md - Environment doctor → Bridge state: checks state
src/utils/doctor.ts - Multi-CLI daemon → Bridge state: reads bridge state
src/daemon/wechat-daemon.ts - WeChat channel → Local CLI user: relays output
README.md - WeCom channel → Local CLI user: relays output
README.md