pulse-gateway

pulse-gateway

Communication bridge between Pulse Service and Pulse Cloud. Connects your local AI development environment to the Pulse dashboard over a secure WebSocket.

Install

npm install -g pulse-gateway

Requires Node.js >= 18.

Usage

Initialize

pulse-gateway init --api-key <your-api-key>

Options:

Flag	Description	Default
--api-key <key>	API key for cloud authentication	required
--endpoint <url>	Cloud WebSocket endpoint	wss://api.multiagentpulse.com/gateway
--project <path>	Project root directory	.

This creates a .pulse/gateway.json config file in your project directory.

Start

pulse-gateway start

Options:

Flag	Description	Default
--foreground	Run in foreground (do not daemonize)	false
--project <path>	Project root directory	.

The gateway reads .pulse/state.json (written by pulse-service) and pushes status updates to the cloud at a configurable interval.

Configuration

The init command writes a .pulse/gateway.json file with these defaults:

Key	Default	Description
cloudEndpoint	wss://api.multiagentpulse.com/gateway	WebSocket endpoint
apiKey	(from --api-key)	Cloud API key
pushInterval	10	Seconds between status pushes
assetUploadEnabled	true	Upload screenshots/recordings
maxAssetSizeMb	50	Max asset file size in MB
serviceApiUrl	http://localhost:9850	Local pulse-service API

License

MIT