registry / relay-companion / 0.1.5

relay-companion@0.1.5

Relay companion: connects local coding agents to Relay tasks, approvals, and connector tools.

AI Security Review

scanned 12d ago · by lpm-firewall-ai

No confirmed malicious attack surface. The package is an explicit Relay companion CLI/MCP/daemon that can persist itself and integrate with local AI agents only after user-invoked setup/install.

Static reason

No blocking static signals were detected.; previous stored version diff introduced dangerous source

Trigger

User runs `relay pair`, `relay setup`, `relay install`, `relay daemon`, `relay mcp`, or `relay open`.

Impact

Package-aligned local Relay integration; no unconsented install-time execution or unrelated data theft identified.

Mechanism

User-invoked Relay CLI, MCP server, daemon, and agent-session materialization

Rationale

Static inspection shows powerful AI-agent integration and persistence features, but they are explicit product functionality activated by user commands and not lifecycle/import-time abuse. No concrete credential harvesting, unrelated exfiltration, destructive action, or unconsented AI-agent control mutation was found.

Evidence

package.jsonbin/relay.jssrc/install.jssrc/config.jssrc/client.jssrc/mcp.jssrc/task-daemon.jssrc/runtime.jssrc/setup-activation.jssrc/codex-session-writer.jssrc/claude-session-writer.jssrc/host-paths.js~/.relay/config.json~/.relay/task-ledger.json~/Library/LaunchAgents/work.relay.companion.plist~/Library/LaunchAgents/work.relay.companion.pill.plist~/.relay-companion~/.codex~/.claude

Network endpoints2

aia6vj5pgp.us-east-1.awsapprunner.comsendrelays.com

Decision evidence

public snapshot

AI called this Clean at 86.0% confidence as Benign with medium false-positive risk.

Evidence for block

src/install.js registers Relay MCP into Claude/Codex and creates macOS LaunchAgents, but only from explicit `relay setup`/`relay install` commands.
src/runtime.js can launch Codex/Claude task agents with permissive settings for Relay background tasks, a high-risk but package-aligned capability.

Evidence against

package.json has no preinstall/install/postinstall lifecycle hooks; main/bin only runs when invoked as `relay`.
bin/relay.js dispatches explicit commands and does not run pairing, install, daemon, or agent launch at import time.
src/config.js stores only Relay device config under ~/.relay and uses documented RELAY_* env overrides.
src/client.js network traffic is to configured Relay API endpoints with bearer device token, matching package purpose.
src/mcp.js exposes Relay messaging/task/connector tools over MCP; no credential harvesting or unrelated exfiltration found.
No obfuscated payloads, destructive filesystem behavior, or reviewer/prompt manipulation found in inspected source.

Behavioral surface

Source

ChildProcessCryptoDynamicRequireEnvironmentVarsFilesystemNetworkShell

Supply chain

HighEntropyStringsUrlStrings

Manifest

NoLicense

scanned 23 file(s), 251 KB of source, external domains: aia6vj5pgp.us-east-1.awsapprunner.com, sendrelays.com, www.apple.com

Source & flagged code

3 flagged

bin/relay.jsView file

Lines 219-259javascript

219

220async function cmdAnswerQuestion(flags) {

221 const taskId = flags.task || flags.taskId;

222 const messageId = flags.message || flags.messageId;

223 let answer = flags.answer;

224 if (!taskId || !messageId) {

225 throw new Error("Usage: relay answer-question --task TASK_ID --message MESSAGE_ID --answer ANSWER");

226 }

227 if (!answer) answer = await prompt("Answer: ");

228 const client = new RelayClient();

229 await client.answerHumanQuestion(taskId, messageId, {

230 answerMarkdown: answer,

231 idempotencyKey: `human_answer_${Date.now()}`,

232 });

233 console.log("Sent answer to Relay. The waiting task agent will resume on the next daemon poll.");

234}

235

236/** Launch the desktop Relay companion pill (Electron overlay). */

237function cmdPill() {

238 const here = path.dirname(fileURLToPath(import.meta.url));

239 const overlayMain = path.resolve(here, "../overlay/main.cjs");

240 // require("electron") returns the path to the electron binary when resolved under node.

241 let electronPath;

Medium

Dynamic Require

Package source references dynamic require/import behavior.

bin/relay.jsView on unpkg · L239

242 try {

243 const require = createRequire(import.meta.url);

244 electronPath = require("electron");

245 } catch (error) {

246 throw new Error(

247 "Electron is not installed. Run `npm install` in packages/companion first. (" +

248 (error && error.message ? error.message : error) +

249 ")",

250 );

251 }

252 if (typeof electronPath !== "string") {

253 throw new Error("Could not resolve the Electron binary. Run `npm install` in packages/companion.");

254 }

255 const child = spawn(electronPath, [overlayMain], {

256 detached: true,

257 stdio: "ignore",

258 env: { ...process.env },

259 });

•matchType = previous_version_dangerous_delta matchedPackage = relay-companion@0.1.3 matchedIdentity = npm:cmVsYXktY29tcGFuaW9u:0.1.3 similarity = 0.762 summary = stored previous version shares package body but lacks this dangerous source file

Critical

Previous Version Dangerous Delta

This package version adds a dangerous source file absent from the previous stored version.

bin/relay.jsView on unpkg

src/install.jsView file

Lines 1-21javascript

1import { spawnSync } from "node:child_process";

2import fs from "node:fs";

Medium

Install Persistence

Source writes installer persistence such as shell profile or service configuration.

src/install.jsView on unpkg · L1

3import os from "node:os";

4import path from "node:path";

5import

Source & flagged code

3 flagged · loading source

bin/relay.jsView file

Critical

Previous Version Dangerous Delta

This package version adds a dangerous source file absent from the previous stored version.

bin/relay.jsView on unpkg

239const overlayMain = path.resolve(here, "../overlay/main.cjs"); L240: // require("electron") returns the path to the electron binary when resolved under node. L241: let electronPath;

Medium

Dynamic Require

Package source references dynamic require/import behavior.

bin/relay.jsView on unpkg · L239

src/install.jsView file

1import { spawnSync } from "node:child_process"; L2: import fs from "node:fs"; ... L50: const rootRes = spawnSync("npm", ["root", "-g"], { encoding: "utf8", timeout: 20_000 }); L51: const root = (rootRes.stdout || "").trim(); L52: const globalBin = path.join(root, ...PACKAGE_NAME.split("/"), "bin", "relay.js"); ... L67: try { L68: const require = createRequire(path.join(packageRoot, "package.json")); L69: const electronPath = require("electron"); ... L97: export function installDaemonAutostart(bin = relayBinPath(), node = process.execPath) { L98: if (process.platform !== "darwin") return { ok: false, reason: "autostart_unsupported_platform" }; L99: const home = os.homedir(); L100: const plistPath = path.join(home, "Library", "LaunchAgents", `${DAEMON_LAUNCH_LABEL}.plist`);

Medium

Install Persistence

Source writes installer persistence such as shell profile or service configuration.

src/install.jsView on unpkg · L1

Findings

1 Critical4 Medium5 Low

CriticalPrevious Version Dangerous Deltabin/relay.js

MediumDynamic Requirebin/relay.js

MediumNetwork

MediumEnvironment Vars

MediumInstall Persistencesrc/install.js

LowScripts Present

LowFilesystem

LowHigh Entropy Strings

LowUrl Strings

LowNo License

Source & flagged code

3 flagged

bin/relay.jsView file

Lines 219-259javascript

219

220async function cmdAnswerQuestion(flags) {

221 const taskId = flags.task || flags.taskId;

222 const messageId = flags.message || flags.messageId;

223 let answer = flags.answer;

224 if (!taskId || !messageId) {

225 throw new Error("Usage: relay answer-question --task TASK_ID --message MESSAGE_ID --answer ANSWER");

226 }

227 if (!answer) answer = await prompt("Answer: ");

228 const client = new RelayClient();

229 await client.answerHumanQuestion(taskId, messageId, {

230 answerMarkdown: answer,

231 idempotencyKey: `human_answer_${Date.now()}`,

232 });

233 console.log("Sent answer to Relay. The waiting task agent will resume on the next daemon poll.");

234}

235

236/** Launch the desktop Relay companion pill (Electron overlay). */

237function cmdPill() {

238 const here = path.dirname(fileURLToPath(import.meta.url));

239 const overlayMain = path.resolve(here, "../overlay/main.cjs");

240 // require("electron") returns the path to the electron binary when resolved under node.

241 let electronPath;

Medium

Dynamic Require

Package source references dynamic require/import behavior.

bin/relay.jsView on unpkg · L239

242 try {

243 const require = createRequire(import.meta.url);

244 electronPath = require("electron");

245 } catch (error) {

246 throw new Error(

247 "Electron is not installed. Run `npm install` in packages/companion first. (" +

248 (error && error.message ? error.message : error) +

249 ")",

250 );

251 }

252 if (typeof electronPath !== "string") {

253 throw new Error("Could not resolve the Electron binary. Run `npm install` in packages/companion.");

254 }

255 const child = spawn(electronPath, [overlayMain], {

256 detached: true,

257 stdio: "ignore",

258 env: { ...process.env },

259 });

Critical

Previous Version Dangerous Delta

This package version adds a dangerous source file absent from the previous stored version.

bin/relay.jsView on unpkg

src/install.jsView file

Lines 1-21javascript

1import { spawnSync } from "node:child_process";

2import fs from "node:fs";

Medium

Install Persistence

Source writes installer persistence such as shell profile or service configuration.

src/install.jsView on unpkg · L1

3import os from "node:os";

4import path from "node:path";

5import