revia-bridge

Standalone, MCP-free realtime bridge plugin for Revia. It runs a background daemon that connects directly to Revia's raw WebSocket (wss://revia.devshub.ai/api/v1/mcp/ws), handles real-time inbound events, and answers bidirectional agent chat by shelling out to a configurable CLI command (e.g. codesync ask "{message}" or claude -p "{message}").

The daemon lifecycle is managed automatically by plugin hooks: SessionStart starts it, SessionEnd/Stop stop it.

Supersedes revia-mcp. The old MCP-based client is deprecated in favor of this package, which has zero MCP dependencies, is installable in any coding agent (not just MCP-capable ones), and runs as a self-managed background daemon rather than a per-session MCP server process.

Install

From PyPI

pip install revia-bridge
revia-bridge init   # interactive one-time setup
revia-bridge run --daemon

CodeSync

codesync plugin marketplace add /path/to/plugins/revia-bridge
codesync plugin install revia-bridge@revia --scope user

Claude Code

claude plugin marketplace add /path/to/plugins/revia-bridge
claude plugin install revia-bridge@revia

The marketplace is named revia; the plugin is named revia-bridge. The install spec is therefore revia-bridge@revia.

Configure

Run the interactive initializer:

revia-bridge init

It prompts for:

This writes ~/.codesync/revia-bridge.json (override with REVIA_BRIDGE_CONFIG). See SKILL.md for the full key reference.

Manual daemon control

revia-bridge run --daemon   # start detached (PID + log under ~/.codesync)
revia-bridge status         # running? last event time?
revia-bridge stop           # SIGTERM via PID file

Development

cd plugins/revia-bridge
python -m pytest -q

The package is a plain Python project (pyproject.toml) with a revia-bridge console-script entry point. It has zero MCP dependencies — only websockets.