Developer API

Ricochet Cloud Bridge

Use the bridge service for remote Ricochet agent sessions, WebSocket transport, and gRPC services that connect chat channels to a local coding agent.

Transport

Ricochet Cloud remains the bridge/control plane for WebSocket and gRPC-over-bridge sessions.

Ricochet Cloud Bridge

wss://cloud.grik.io/ws

Bridge services

These service names describe the bridge interfaces used by local Ricochet agents.

InterfaceDescription
GET /health

Return bridge service health and active session count.

WebSocket /ws

Upgrade to the Ricochet Cloud Bridge transport; gRPC runs over the WebSocket tunnel.

BridgeService.Handshake

Register a local Ricochet agent session and bind it to the authenticated Grik user.

ChatService.StreamEvents

Stream incoming chat, tool, and heartbeat events from Telegram or other channels to the local agent.

ChatService.SendMessage

Send an agent response back to a chat channel such as Telegram.

STTService.Transcribe

Upload audio chunks and receive a transcription for voice-controlled coding sessions.