@twing/cli@1.2.1

AI Security Review

scanned 11d ago · by lpm-firewall-ai

The install hook is gated to global installs or an explicit setup flag, but that gate still permits automatic first-party agent configuration changes during a global install. This warrants a warning for agent extension lifecycle risk; the inspected behavior does not establish a concrete attack.

Static reason

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

Trigger

Installing the package globally, or passing --machine-setup to its postinstall script.

Impact

The package becomes active in the user’s Claude, OpenCode, and Codex environments; the reviewed source does not establish an unrelated control hijack or credential theft.

Mechanism

The postinstall hook calls machine setup, which writes Claude resolver wiring, installs an OpenCode plugin, and wires Codex hooks.

AI rationale

Evidence

package.jsonpostinstall.cjsdist/machine-setup.jsdist/codex-hooks.jsdist/enforce-hooks.jsdist/init.jsdist/resolve-hook.js~/.claude/settings.json~/.codex/config.toml~/.config/opencode

Decision evidence

public snapshot

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

Evidence for warning

package.json defines a postinstall hook that runs postinstall.cjs.
The hook imports and runs machine setup for global installs or when explicitly passed --machine-setup.
Machine setup writes Claude resolver wiring, installs the OpenCode plugin, and wires Codex hooks.
The Codex target is the user-level config.toml; the cited Claude, OpenCode, and Codex files describe agent configuration destinations.
twing init also wires hooks into the repository’s Claude settings.
The resolver targets user-level Claude settings for sessions started outside a repository.

Evidence against

The postinstall script exits for installs that are not global and do not pass --machine-setup.
The package describes the machine wiring as setup for its own CLI and agent integrations.

Behavioral surface

Source

ChildProcessCryptoEnvironmentVarsFilesystemNetwork

Supply chain

HighEntropyStringsUrlStrings

Source & flagged code

7 flagged

package.jsonView file

Lines 9-38json

9 "bin": {

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

11 },

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

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

14 "repository": {

15 "type": "git",

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

17 "directory": "packages/cli"

18 },

19 "files": [

20 "dist",

21 "postinstall.cjs",

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

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

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

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

26 ],

27 "scripts": {

28 "build": "tsc -b",

29 "postinstall": "node postinstall.cjs",

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L29

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg · L29

30 "typecheck": "tsc --noEmit",

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

32 },

33 "dependencies": {

34 "@twing/core": "^1.2.1",

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

36 }

37}

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/daemon/opencode-sqlite-source.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/daemon/opencode-sqlite-source.js#virtual:normalized:round1View on unpkg

dist/codex-hooks.jsView file

•matchType = previous_version_dangerous_delta matchedPackage = @twing/cli@0.2.26 matchedIdentity = npm:QHR3aW5nL2NsaQ:0.2.26 similarity = 0.595 summary = stored previous version shares package body but lacks this dangerous source file

High

Previous Version Dangerous Delta

This package version adds a dangerous source file absent from the previous stored version; route for source-aware review.

dist/codex-hooks.jsView 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 Critical5 High4 Medium4 Low

CriticalAi Agent Control Hijackdist/machine-setup.js

HighInstall Time Lifecycle Scriptspackage.json

HighChild Processdist/opencode-adapter.js

HighSame File Env Network Executiondist/test-support.js

HighSemantic Analysis Limiteddist/daemon/opencode-sqlite-source.js#virtual:normalized:round1

HighPrevious Version Dangerous Deltadist/codex-hooks.js

MediumAmbiguous Install Lifecycle Scriptpackage.json

MediumNetwork

MediumEnvironment Vars

MediumStructural Risk Force Deep Review

LowScripts Present

LowFilesystem

LowHigh Entropy Strings

Affected versions and remediation

This report applies to @twing/cli@1.2.1.

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

Review the evidence and your use of @twing/cli@1.2.1 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 21:26:27.245Z (UTC).

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