NordRelayRemote control for coding agents.

Operate Codex, Pi, Hermes, OpenClaw, and Claude Code sessions through a login-protected WebUI, chat adapters, and trusted peer nodes.

Quickstart

CLI reference

GitHub

One control plane

Use the same session controls from the WebUI, Telegram, Discord, Slack, Matrix, and paired NordRelay nodes.

Multi-agent by design

Route prompts to Codex, Pi, Hermes, OpenClaw, or Claude Code without changing the user and permission model.

Secure by default

WebUI login, user groups, linked chat identities, registered channels, scoped peers, and redacted diagnostics are built in.

What NordRelay is

NordRelay is a local-first bridge for coding-agent sessions. It keeps private runtime state in ~/.nordrelay, exposes a login-protected WebUI, and can connect approved users to selected chat channels and trusted peer nodes.

It is useful when you want to keep a coding agent running on a workstation or server, monitor active sessions, queue prompts, approve actions, stream results, transfer artifacts, or control agents across machines without opening broad unauthenticated access.

Fast path

bash

npm install -g @nordbyte/nordrelay
nordrelay init
nordrelay doctor
nordrelay web

Open the URL printed by nordrelay web. The first WebUI run creates the initial admin user. After that, every dashboard page, API route, chat command, artifact download, and event stream requires an authenticated NordRelay user.

Main surfaces

WebUI

Chat, sessions, queue planning, workflows, users, settings, peers, logs, diagnostics, metrics, versions, and artifacts.

Chat adapters

Telegram, Discord, Slack, and Matrix share the same command core, linked-user access checks, queue behavior, mirroring, and artifacts.

Peer federation

Pair NordRelay instances with explicit codes, TLS fingerprints, scopes, workspace allow-lists, and optional outbound relay mode.

Agent adapters

Codex, Pi, Hermes, OpenClaw, and Claude Code adapters expose sessions, launch profiles, model controls, approvals, updates, and diagnostics where supported.

Next steps

Install and initialize NordRelay in Installation.
Create the first admin and run checks in Quickstart.
Learn the runtime model in Core concepts.
Configure adapters in Chat adapters and Agents.
Use the CLI reference in Commands.