registry / AI-agent control-surface risk / @twing/cli / 0.2.28

@twing/cli@0.2.28

AI Security Review

scanned 11d ago · by lpm-firewall-ai

The postinstall invokes machine setup for global installs, which writes machine-wide Claude and OpenCode integrations without separate confirmation. This is an unconsented install-time mutation of AI-agent control surfaces, meeting the blocking policy.

Static reason

High-risk behavior combination matched malicious policy.; previous stored version diff introduced dangerous source

Trigger

Installing the package globally with npm.

Impact

The package gains automatic participation in future Claude and OpenCode sessions across directories on that machine.

Mechanism

The postinstall starts machine setup, which writes resolver hooks into the user's Claude settings and installs a plugin in OpenCode's auto-loaded plugin directory, without a separate setup confirmation.

Policy narrative

A global npm installation triggers postinstall machine setup. That setup adds Claude hooks and an OpenCode plugin in machine-wide, automatically loaded configuration locations. The inspected lifecycle path contains no separate consent step before these agent integrations are written.

AI rationale

Evidence

package.jsonpostinstall.cjsdist/machine-setup.jsdist/resolve-hook.jsdist/opencode-plugin.js~/.claude/settings.json~/.config/opencode/plugins/twing.js~/.twing/bin/twing-resolve~/.twing/opencode/adapter.mjs

Decision evidence

public snapshot

AI identified this as a dangerous AI-agent capability at 96.0% confidence with low false-positive risk.

Evidence for policy risk

package.json runs postinstall.cjs during installation.
The postinstall runs machine setup for global installs without a separate setup confirmation.
Machine setup writes Claude resolver hooks and installs the OpenCode plugin.
The resolver merges hooks into user-level Claude settings and writes them to disk.
The OpenCode plugin is placed in the user's auto-loaded plugin directory.
The inspected integration files describe repo hook setup, init wiring, and machine-wide resolver wiring.

Evidence against

Behavioral surface

Source

ChildProcessCryptoEnvironmentVarsFilesystemNetworkShell

Supply chain

HighEntropyStringsUrlStrings

ManifestNo manifest risk signals triggered.

scanned 43 file(s), 343 KB of source, external domains: coordination-server.twing.dev, github.com

Source & flagged code

7 flagged

package.jsonView file

Lines 6-35json

6 "bin": {

7 "twing": "./dist/index.js"

8 },

9 "main": "./dist/index.js",

10 "types": "./dist/index.d.ts",

11 "repository": {

12 "type": "git",

13 "url": "https://github.com/Twing-dev/twing-cli.git",

14 "directory": "packages/cli"

15 },

16 "files": [

17 "dist",

18 "postinstall.cjs",

19 "!dist/**/*.test.js",

20 "!dist/**/*.test.js.map",

21 "!dist/**/*.test.d.ts",

22 "!dist/**/*.test.d.ts.map"

23 ],

24 "scripts": {

25 "build": "tsc -b",

26 "postinstall": "node postinstall.cjs",

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L26

Medium

Ambiguous Install Lifecycle Script

Install-time lifecycle script is not statically allowlisted and needs review.

package.jsonView on unpkg · L26

27 "typecheck": "tsc --noEmit",

28 "test": "node --test dist/*.test.js dist/*/*.test.js"

29 },

30 "dependencies": {

31 "@twing/core": "^0.2.28",

32 "web-tree-sitter": "^0.26.12"

33 }

34}

dist/opencode-adapter.jsView file

Lines 1-32javascript

1/**

2 * OpenCode -> twing-hook adapter.

3 *

4 * OpenCode plugins run inside the long-lived OpenCode process, while the

5 * existing twing client contract is one JSON payload per short-lived hook

6 * process. Keeping the translation here means OpenCode shares the exact Go

7 * gate, auth recovery, daemon protocol, and target-file repo resolution

8 * Claude already uses instead of growing a second implementation.

9 *

10 * Copied verbatim to `~/.twing/opencode/adapter.mjs` by `opencode-plugin.ts`,

dist/test-support.jsView file

Lines 14-54javascript

14import * as fs from "node:fs";

15import * as os from "node:os";

16import * as path from

dist/machine-setup.jsView file

Lines 1-24javascript

1/**

2 * Machine wiring shared by the one-step install and `twing init --ghuser`.

3 *

4 * Both leave a machine in the same state: the resolver wired into

5 * `~/.claude/settings.json`, the OpenCode plugin installed, and nothing

6 * installed into `~/.twing/lib`. The coordinator picks the version, so the CLI,

Critical

Ai Agent Control Hijack

Source creates an unconsented AI-agent control surface through install-time mutation or a default unauthenticated remote skill channel.

dist/machine-setup.jsView on unpkg · L4

7 * hook binary and daemon arrive lazily the first time a session opens a repo

8 * that uses twing -- and version recovery keeps them current from then on.

dist/design.js#virtual:normalized:round1View file

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

High

Semantic Analysis Limited

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

dist/design.js#virtual:normalized:round1View on unpkg

Source & flagged code

7 flagged · loading source

package.jsonView file

•scripts.postinstall = node postinstall.cjs

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

•scripts.postinstall = node postinstall.cjs

Medium

Ambiguous Install Lifecycle Script

Install-time lifecycle script is not statically allowlisted and needs review.

package.jsonView on unpkg

dist/opencode-adapter.jsView file

12*/ L13: import { spawn } from "node:child_process"; L14: import * as fs from "node:fs";

High

Child Process

Package source references child process execution.

dist/opencode-adapter.jsView on unpkg · L12

Findings

1 Critical6 High4 Medium4 Low

CriticalAi Agent Control Hijackdist/machine-setup.js

HighInstall Time Lifecycle Scriptspackage.json

HighChild Processdist/opencode-adapter.js

HighShell

HighSame File Env Network Executiondist/test-support.js

HighSemantic Analysis Limiteddist/design.js#virtual:normalized:round1

HighPrevious Version Dangerous Deltadist/opencode-adapter.js

MediumAmbiguous Install Lifecycle Scriptpackage.json

MediumNetwork

MediumEnvironment Vars

MediumStructural Risk Force Deep Review

LowScripts Present

LowFilesystem

Low

Affected versions and remediation

This report applies to @twing/cli@0.2.28.

See all versions of @twing/cli for other recorded verdicts.

Avoid installing @twing/cli@0.2.28. Remove it from direct dependencies and check your lockfile for transitive copies.
Choose an independently verified alternative or release. This report does not establish that other versions are safe.
If this version ran, investigate the affected machine and build environment. Rotate credentials it could access and rebuild from a trusted environment.

Evidence last updated: 2026-10-11 21:24:46.171Z (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

Related packages

Other AI-agent control-surface risk packages

Behavioral surface

Source & flagged code

Related packages

Other AI-agent control-surface risk packages