registry / triflux / 10.49.0

triflux@10.49.0

CLI-first multi-model orchestrator for Claude Code — route tasks to Codex, Antigravity, and Claude

AI Security Review

scanned 11d ago · by lpm-firewall-ai

The scanner's credential hint resolves to Synapse registration that sends a hub token to the configured hub URL or loopback. The package also configures its own Codex hooks through setup, which warrants a warning under the agent integration policy but does not establish a concrete attack.

Static reason

One or more suspicious static signals were detected.; previous stored version diff introduced dangerous source

Trigger

Running the package setup flow when a Codex home directory exists.

Impact

Those Triflux commands can run on later Codex events; no confirmed malicious action or credential exfiltration was identified.

Mechanism

The setup code adds Triflux session-start and prompt-submit commands to Codex hooks configuration and updates related hook state.

AI rationale

Evidence

scripts/setup.mjsscripts/ensure-codex-hooks.mjs~/.codex/hooks.json~/.codex/config.toml

Decision evidence

public snapshot

AI called this Suspicious at 84.0% confidence as Dangerous Capability with medium false-positive risk.

Evidence for warning

The package provides CLI entrypoints and declares ordinary dependencies; no npm lifecycle hook was found in its manifest.
The setup flow calls ensureCodexHooks, which adds Triflux command hooks for Codex session start and prompt submission.
Hook installation writes Codex hooks.json and config.toml when the Codex home exists; this is a first-party agent integration setup capability.
Synapse registration reads a hub token and sends it to a hub URL configured by TFX_HUB_URL, or defaults to loopback.
The reviewed integration target locations concern local cache, registry, or account state paths; they do not establish a separate attack.

Evidence against

The manifest has no preinstall, install, or postinstall hook, so npm installation does not itself activate the Codex configuration changes.
The Codex hooks invoke Triflux's own session hook, and installation is limited to an existing Codex home.
Synapse requests are directed to the configured hub or loopback endpoint, not to a fixed unrelated recipient.

Behavioral surface

Source

ChildProcess

Source & flagged code

15 flagged

bin/tfx-live.mjsView file

Lines 1-21javascript

1#!/usr/bin/env node

2import { execFile } from "node:child_process";

3import { mkdirSync, realpathSync, statSync, writeFileSync } from "node:fs";

High

Child Process

Package source references child process execution.

bin/tfx-live.mjsView on unpkg · L1

4import {

5 mkdir,

6 open,

7 readdir,

8 readFile,

9 rm,

10 writeFile,

11} from "node:fs/promises";

12import { homedir, tmpdir } from "node:os";

13import { join as pathJoin, resolve as pathResolve } from "node:path";

14import { fileURLToPath } from "node:url";

15import { promisify } from "node:util";

16import { runHygiene } from "../cto/hygiene.mjs";

17import { notifyCtoHygieneOnce } from "../cto/hygiene-notify.mjs";

18import {

19 codexThreadNames,

20 readCodexSessionRecords,

21 registryDir,

bin/triflux.mjsView file

Lines 2194-2234javascript

2194 }

2195 // Stale 스킬 정리 (패키지에서 제거된 tfx-* 스킬 삭제)

2196 const staleCleanup = cleanupStaleSkills(skillsDst, skillsSrc);

2197 if (staleCleanup.count > 0) {

2198 ok(

bin/tfx-setup-tui.mjsView file

Lines 1-8javascript

1#!/usr/bin/env node

2import { dirname, join } from "node:path";

3// tfx-setup-tui — Interactive Setup Wizard TUI entry point

4import { fileURLToPath } from "node:url";

6const root = dirname

hooks/hook-orchestrator.mjsView file

Lines 1-30javascript

1#!/usr/bin/env node

3// hooks/hook-orchestrator.mjs — 범용 훅 체이닝 엔진

4//

5// settings.json에 이벤트당 하나만 등록. stdin JSON에서 이벤트명+툴명을 읽고

6// hook-registry.json의 우선순위대로 훅을 순차 실행한다.

7//

8// 실행 규칙:

9// - priority 낮을수록 먼저 실행 (triflux=0, omc=50, external=100)

10// - blocking:true 훅이 exit 2 반환 → 즉시 중단, 이후 훅 건너뜀

11// - 출력(stdout JSON)은 마지막 유효 출력으로 머지

scripts/setup.mjsView file

Lines 1-27javascript

1#!/usr/bin/env node

3// triflux 세션 시작 시 자동 설정 스크립트

4// - tfx-route.sh를 ~/.claude/scripts/에 동기화

5// - hud-qos-status.mjs를 ~/.claude/hud/에 동기화

6// - skills/를 ~/.claude/skills/에 동기화

8import { execFileSync, spawn } from "child_process";

9import {

Medium

hub/team/synapse-http.mjsView file

Lines 1-21javascript

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

2import { createHash } from "node:crypto";

3import { existsSync, readFileSync } from "node:fs";

4import { homedir, hostname } from "node:os";

scripts/mcp-check.mjsView file

•Runtime or CLI code links a write operation to an explicit external AI-agent control path: for (const mcpjson of scanpluginsmcpjson()) { for (const { name, config } of extractmcpservernames(mcpjson)) { if (!servermap.has(name)) { servermap.set(name, createserverrecord(name, "configured", config)); } } } for (const settingsfile of ["settings.json", "settings.local.json"]) { const data = readjsonsafe(join(claude_dir, settingsfile)); if (!data?.mcpservers) continue; for (const [name, config] of object.entries(data.mcpservers)) { if (typeof name !== "string" || !name.trim()) continue; if (!servermap.has(name.trim())) { servermap.set( name.trim(),

High

External Ai Agent Control Surface Mutation

Runtime or CLI source writes behavior-bearing configuration into a user or project AI-agent control surface.

scripts/mcp-check.mjsView on unpkg

scripts/ensure-codex-hooks.mjsView file

•Manifest-trigger-reachable source links an external AI-agent control path to a behavior-bearing write operation. *\\{\\s*trusted_hash\\s*=\\s*"([^"]+)"`, "gm", ); const tablere = new regexp( `^\\[hooks\\.state\\.(${escapedkeys.join("|")})\\]\\s*\\n[ \\t]*trusted_hash\\s*=\\s*"([^"]+)"`, "gm", ); for (const re of [inlinere, tablere]) { let m = re.exec(content); while (m) { found.push({ key: m[1].replace(/^"|"$/g, ""), hash: m[2] }); m = re.exec(content); } } return found; } function hooksstateconverged(content, entries, hookspath) { const managedkeys = new set(entries.map((entry) => entry.key)); const found = collectmanagedstate(content, managedkeys, hookspath); return entries.every((entry) => { const matches = found.filter((f) => f

High

Trigger Reachable External Ai Agent Control Surface Mutation

Manifest-trigger-reachable source writes behavior-bearing configuration into a user or project AI-agent control surface.

scripts/ensure-codex-hooks.mjsView on unpkg

scripts/completions/tfx.zshView file

•path = scripts/completions/tfx.zsh kind = build_helper sizeBytes = 4819 magicHex = [redacted]

Medium

Ships Build Helper

Package ships non-JavaScript build or shell helper files.

scripts/completions/tfx.zshView on unpkg

hub/lib/process-utils.mjs#virtual:normalized:round1View file

•stage = ast_semantic_analysis; reason = ast_parse_error; limitedFiles = 8

High

Semantic Analysis Limited

A bounded semantic-analysis stage reached its safety limit; remaining detectors completed, but this package requires AI review.

hub/lib/process-utils.mjs#virtual:normalized:round1View on unpkg

hub/team/headless.mjsView file

•matchType = previous_version_dangerous_delta matchedPackage = triflux@10.41.1 matchedIdentity = npm:dHJpZmx1eA:10.41.1 similarity = 0.458 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; route for source-aware review.

hub/team/headless.mjsView on unpkg

Source & flagged code

15 flagged · loading source

bin/tfx-live.mjsView file

1#!/usr/bin/env node L2: import { execFile } from "node:child_process"; L3: import { mkdirSync, realpathSync, statSync, writeFileSync } from "node:fs";

High

Child Process

Package source references child process execution.

bin/tfx-live.mjsView on unpkg · L1

bin/triflux.mjsView file

2214L2215: // ── psmux 기본 셸 자동 수정 (cmd.exe → PowerShell) ── L2216: if (process.platform === "win32" && which("psmux")) {

High

Shell

Package source references shell execution.

bin/triflux.mjsView on unpkg · L2214

2349if (existsSync(join(PKG_ROOT, "hub", "server.mjs"))) { L2350: const defaultHubUrl = `http://127.0.0.1:${process.env.TFX_HUB_PORT || "27888"}/mcp`; L2351: autoRegisterMcp(defaultHubUrl, { codexEnabled: false }); ... L2360: const script = join(PKG_ROOT, "scripts", "setup.mjs"); L2361: execFileSync( L2362: process.execPath,

High

Same File Env Network Execution

A single source file combines environment access, network access, and code or shell execution; review context before blocking.

Findings

1 Critical10 High6 Medium4 Low

CriticalPrevious Version Dangerous Deltahub/team/headless.mjs

HighChild Processbin/tfx-live.mjs

HighShellbin/triflux.mjs

HighSame File Env Network Executionbin/triflux.mjs

HighCredential Exfiltrationhub/team/synapse-http.mjs

HighExternal Ai Agent Control Surface Mutationscripts/mcp-check.mjs

HighTrigger Reachable External Ai Agent Control Surface Mutationscripts/ensure-codex-hooks.mjs

HighTrigger Reachable Credential Exfiltrationhub/team/synapse-http.mjs

HighTrigger Reachable Persistencescripts/setup.mjs

HighRuntime Package Installbin/triflux.mjs

HighSemantic Analysis Limitedhub/lib/process-utils.mjs#virtual:normalized:round1

Affected versions and remediation

This report applies to triflux@10.49.0.

See all versions of triflux for other recorded verdicts.

Review the evidence and your use of triflux@10.49.0 before allowing it. Restrict the permissions described in this report.
Choose an independently verified alternative or release. This report does not establish that other versions are safe.

Evidence last updated: 2026-10-11 19:09:40.177Z (UTC).

Think this verdict is wrong? Dispute it on GitHub or read how reports are produced.

AI Security Review

Decision evidence

Source & flagged code

Source & flagged code

Findings

Affected versions and remediation

Runtime surface

Behavioral surface

Source & flagged code