@saleso.innovations/bridge

Connect your Hermes agent to the Cleos iOS app with a pairing code.

VPS quick install

Get a pairing code from the Cleos app, then on the machine where Hermes runs:

curl -fsSL https://amicable-elephant-407.convex.site/install-bridge.sh | bash -s -- ABCD1234

Requirements:

• Node.js 20+
• Hermes installed on the same machine (hermes gateway — the install script configures the API automatically)

Update

After the first install, updates are one command:

cleos-bridge update

The install script links cleos-bridge to /usr/local/bin (root) or ~/.local/bin (non-root). If that command is not found yet, use:

curl -fsSL https://amicable-elephant-407.convex.site/update-bridge.sh | bash

This installs the latest package, refreshes the CLI symlink, and restarts cleos-bridge.service when present.

To pin a specific release (e.g. after a Cleos update):

curl -fsSL https://amicable-elephant-407.convex.site/update-bridge.sh | bash -s -- 0.1.22

Manual usage

The install script puts the bridge in ~/.cleos/bridge. To run without the symlink:

node ~/.cleos/bridge/node_modules/@saleso.innovations/bridge/dist/cli.js pair ABCD1234
node ~/.cleos/bridge/node_modules/@saleso.innovations/bridge/dist/cli.js start

Or install globally if you prefer:

npm install -g @saleso.innovations/bridge
cleos-bridge connect ABCD1234   # first-time pairing
cleos-bridge start              # reconnecting daemon (systemd)

Credentials are saved to ~/.cleos/agent.json.

The daemon watches ~/.hermes/cron/output/ and forwards new cron results to the Cleos Jobs tab automatically.

To recover missed cron output (for example after a bridge restart):

cleos-bridge cron-backfill --list
cleos-bridge cron-backfill --reset

Hermes API

By default the bridge forwards chat to Hermes at http://127.0.0.1:8642/v1/chat/completions. Override with HERMES_API_URL or HERMES_API_KEY if needed.

See INTEGRATION.md for native Hermes gateway integration.