registry / @swirls/cli / 0.1.104

@swirls/cli@0.1.104

Swirls command line application

AI Security Review

scanned 6h ago · by lpm-firewall-ai

The package executes a remote shell script during npm postinstall for global installs. That remote script controls what binary is installed and copied into the package entrypoint without integrity verification.

Static reason

High-risk behavior combination matched malicious policy.; source matched previously finalized malicious package; routed for review; source fingerprint signature matched known malicious package; routed for review

Trigger

Global npm/Bun install with lifecycle scripts enabled

Impact

Untrusted remote code can run with installer user privileges and replace the CLI binary at install time.

Mechanism

install-time curl-to-bash remote code execution

Attack narrative

On global installation, npm runs scripts/install.js. The hook skips CI, Windows, and non-global installs, then executes curl -fsSL https://swirls.ai/install | bash using a shell. If that installer creates ~/.local/bin/swirls, the hook copies it over bin/swirls and marks it executable, making remote install-time code determine the published CLI entrypoint.

Rationale

Source inspection confirms lifecycle-triggered remote shell execution and binary replacement without integrity checks. Even though the endpoint is package-aligned, this is a concrete install-time remote code execution attack surface suitable for blocking.

Evidence

package.jsonscripts/install.jsbin/swirlsREADME.md~/.local/bin/swirls

Network endpoints1

swirls.ai/install

Decision evidence

public snapshot

AI called this Malicious at 92.0% confidence as Malware with low false-positive risk.

Evidence for block

package.json defines postinstall: node scripts/install.js
scripts/install.js runs execSync with shell:true: curl -fsSL https://swirls.ai/install | bash
Remote shell execution is lifecycle-triggered on global npm/Bun installs outside CI and non-Windows
scripts/install.js copies ~/.local/bin/swirls into package bin/swirls after remote installer runs
No checksum, pinned artifact URL, or local packaged binary is present

Evidence against

Hook is gated to global installs and skips CI/Windows
Endpoint is package-aligned with author/docs domain swirls.ai
No source evidence of credential harvesting, broad file enumeration, AI-agent config writes, or exfiltration in packaged files

Behavioral surface

Source

ChildProcessEnvironmentVarsFilesystemShell

Supply chain

UrlStrings

Manifest

NoLicense

scanned 1 file(s), 1.35 KB of source, external domains: swirls.ai

Source & flagged code

9 flagged

package.jsonView file

Lines 1-41json

2 "name": "@swirls/cli",

3 "version": "0.1.104",

4 "description": "Swirls command line application",

5 "author": {

6 "name": "Swirls",

7 "url": "https://swirls.ai"

8 },

9 "type": "module",

10 "bin": {

11 "swirls": "./bin/swirls"

12 },

13 "files": [

14 "bin",

15 "scripts/install.js"

16 ],

17 "scripts": {

18 "build": "bun run scripts/build.ts",

19 "depcruise": "bun ../../.github/scripts/depcruise-workspace.mjs",

20 "dev": "bun run --watch src/bin/cli.ts",

21 "postinstall": "node scripts/install.js",

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L21

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg · L21

22 "test": "bun test",

23 "test:coverage": "bun test --coverage --coverage-reporter=lcov --coverage-reporter=text",

24 "version": "bun run scripts/version.ts"

25 },

26 "devDependencies": {

27 "@byteslice/result": "0.3.0",

28 "@clack/prompts": "1.0.0",

29 "@elysiajs/eden": "1.4.8",

30 "@orpc/client": "1.13.14",

31 "@orpc/contract": "1.13.14",

32 "@stricli/core": "1.2.4",

33 "@swirls/agent": "0.0.1",

34 "@swirls/auth": "0.1.0",

35 "@swirls/contract": "0.0.1",

36 "@swirls/deploy": "0.0.1",

37 "@swirls/execution-events": "0.0.1",

38 "@swirls/language": "0.0.77",

39 "@swirls/registry": "0.0.1",

40 "@swirls/schemas": "0.0.1",

41 "@swirls/sdk": "1.1.5",

scripts/install.jsView file

Lines 1-60javascript

1#!/usr/bin/env node

3/**

4 * Runs the install script for platform detection and binary

5 * download, then copies the binary into bin/ so `swirls` runs the real

6 * binary (no Node wrapper).

7 *

8 * Skips installation in the following cases:

9 * - CI environment

10 * - Not installed globally

11 * - Windows (no curl/bash)

12 */

14import { execSync } from 'node:child_process'

15import { chmodSync, copyFileSync, existsSync } from 'node:fs'

High

Child Process

Package source references child process execution.

scripts/install.jsView on unpkg · L13

16import { dirname, join } from 'node:path'

17import { fileURLToPath } from 'node:url'

19const INSTALL_URL = 'https://swirls.ai/install'

21const SCRIPT_DIR =

22 typeof import.meta.dir === 'string'

23 ? import.meta.dir

24 : dirname(fileURLToPath(import.meta.url))

26const PACKAGE_ROOT = join(SCRIPT_DIR, '..')

28const INSTALLED_BINARY = join(

29 process.env.HOME || process.env.USERPROFILE || '',

30 '.local',

31 'bin',

32 'swirls',

33)

35const BIN_SWIRLS = join(PACKAGE_ROOT, 'bin', 'swirls')

37if (process.env.CI === 'true' || process.env.CI === '1') {

38 process.exit(0)

Critical

Download Execute

Source downloads or fetches remote code and executes it.

scripts/install.jsView on unpkg · L13

Critical

Trigger Reachable Dangerous Capability

A package entrypoint or install-time lifecycle script reaches a source file with blocking dangerous behavior.

scripts/install.jsView on unpkg · L13

High

Sandbox Evasion Gated Capability

Source gates dangerous network, credential, or execution behavior behind CI, host, platform, time, or geo fingerprint checks.

scripts/install.jsView on unpkg · L13

39}

40if (process.platform === 'win32') {

41 process.exit(0)

42}

43if (!process.env.npm_config_global && !process.env.BUN_INSTALL_GLOBAL) {

44 process.exit(0)

45}

47try {

48 execSync(`curl -fsSL ${INSTALL_URL} | bash`, {

49 stdio: 'inherit',

50 shell: true,

51 })

High

Shell

Package source references shell execution.

scripts/install.jsView on unpkg · L49

52} catch (_err) {

53 process.exit(1)

54}

56if (existsSync(INSTALLED_BINARY)) {

57 copyFileSync(INSTALLED_BINARY, BIN_SWIRLS)

58 chmodSync(BIN_SWIRLS, 0o755)

59}

•matchType = normalized_sha256 matchedPackage = @swirls/cli@0.1.105 matchedPath = scripts/install.js matchedIdentity = npm:QHN3aXJscy9jbGk:0.1.105 similarity = 1.000 summary = normalized source hash matched finalized malicious source

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

scripts/install.jsView on unpkg

•matchType = malicious_source_fingerprint_signature signature = 87fc30553c66ec35 signatureType = suspicious_hashes sourceLabel = final_verdict:malicious matchedPackage = @swirls/cli@0.1.105 matchedPath = scripts/install.js matchedIdentity = npm:QHN3aXJscy9jbGk:0.1.105 similarity = 1.000 shingleOverlap = 1 summary = package final verdict is malicious

High

Known Malware Source Fingerprint Signature

Source fingerprint signature matches a known malicious package signature; route for source-aware review.

scripts/install.jsView on unpkg

Source & flagged code

9 flagged · loading source

package.jsonView file

•scripts.postinstall = node scripts/install.js

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg

•scripts.postinstall = node scripts/install.js

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg

scripts/install.jsView file

13L14: import { execSync } from 'node:child_process' L15: import { chmodSync, copyFileSync, existsSync } from 'node:fs' ... L18: L19: const INSTALL_URL = 'https://swirls.ai/install' L20: ... L28: const INSTALLED_BINARY = join( L29: process.env.HOME || process.env.USERPROFILE || '', L30: '.local', ... L36: L37: if (process.env.CI === 'true' || process.env.CI === '1') { L38: process.exit(0)

Critical

Download Execute

Source downloads or fetches remote code and executes it.

scripts/install.jsView on unpkg · L13

13Trigger-reachable chain: scripts.postinstall -> scripts/install.js L13: L14: import { execSync } from 'node:child_process' L15: import { chmodSync, copyFileSync, existsSync } from 'node:fs' ... L18: L19: const INSTALL_URL = 'https://swirls.ai/install' L20: ... L28: const INSTALLED_BINARY = join( L29: process.env.HOME || process.env.USERPROFILE || '', L30: '.local', ... L36: L37: if (process.env.CI === 'true' || process.env.CI === '1') { L38: process.exit(0)

Critical

Trigger Reachable Dangerous Capability

A package entrypoint or install-time lifecycle script reaches a source file with blocking dangerous behavior.

scripts/install.jsView on unpkg · L13

13L14: import { execSync } from 'node:child_process' L15: import { chmodSync, copyFileSync, existsSync } from 'node:fs'

High

Child Process

Package source references child process execution.

scripts/install.jsView on unpkg · L13

49stdio: 'inherit', L50: shell: true, L51: })

High

Shell

Package source references shell execution.

scripts/install.jsView on unpkg · L49

High

Sandbox Evasion Gated Capability

Source gates dangerous network, credential, or execution behavior behind CI, host, platform, time, or geo fingerprint checks.

scripts/install.jsView on unpkg · L13

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

scripts/install.jsView on unpkg

High

Known Malware Source Fingerprint Signature

Source fingerprint signature matches a known malicious package signature; route for source-aware review.

scripts/install.jsView on unpkg

Findings

2 Critical6 High3 Medium4 Low

CriticalDownload Executescripts/install.js

CriticalTrigger Reachable Dangerous Capabilityscripts/install.js

HighInstall Time Lifecycle Scriptspackage.json

HighChild Processscripts/install.js

HighShellscripts/install.js

HighSandbox Evasion Gated Capabilityscripts/install.js

HighKnown Malware Source Similarityscripts/install.js

HighKnown Malware Source Fingerprint Signaturescripts/install.js

MediumAmbiguous Install Lifecycle Scriptpackage.json

MediumEnvironment Vars

MediumStructural Risk Force Deep Review

LowScripts Present

LowFilesystem

LowUrl Strings

LowNo License

Source & flagged code

9 flagged

package.jsonView file

Lines 1-41json

2 "name": "@swirls/cli",

3 "version": "0.1.104",

4 "description": "Swirls command line application",

5 "author": {

6 "name": "Swirls",

7 "url": "https://swirls.ai"

8 },

9 "type": "module",

10 "bin": {

11 "swirls": "./bin/swirls"

12 },

13 "files": [

14 "bin",

15 "scripts/install.js"

16 ],

17 "scripts": {

18 "build": "bun run scripts/build.ts",

19 "depcruise": "bun ../../.github/scripts/depcruise-workspace.mjs",

20 "dev": "bun run --watch src/bin/cli.ts",

21 "postinstall": "node scripts/install.js",

High

Install Time Lifecycle Scripts

Package defines install-time lifecycle scripts.

package.jsonView on unpkg · L21

Medium

Ambiguous Install Lifecycle Script

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

package.jsonView on unpkg · L21

22 "test": "bun test",

23 "test:coverage": "bun test --coverage --coverage-reporter=lcov --coverage-reporter=text",

24 "version": "bun run scripts/version.ts"

25 },

26 "devDependencies": {

27 "@byteslice/result": "0.3.0",

28 "@clack/prompts": "1.0.0",

29 "@elysiajs/eden": "1.4.8",

30 "@orpc/client": "1.13.14",

31 "@orpc/contract": "1.13.14",

32 "@stricli/core": "1.2.4",

33 "@swirls/agent": "0.0.1",

34 "@swirls/auth": "0.1.0",

35 "@swirls/contract": "0.0.1",

36 "@swirls/deploy": "0.0.1",

37 "@swirls/execution-events": "0.0.1",

38 "@swirls/language": "0.0.77",

39 "@swirls/registry": "0.0.1",

40 "@swirls/schemas": "0.0.1",

41 "@swirls/sdk": "1.1.5",

scripts/install.jsView file

Lines 1-60javascript

1#!/usr/bin/env node

3/**

4 * Runs the install script for platform detection and binary

5 * download, then copies the binary into bin/ so `swirls` runs the real

6 * binary (no Node wrapper).

7 *

8 * Skips installation in the following cases:

9 * - CI environment

10 * - Not installed globally

11 * - Windows (no curl/bash)

12 */

14import { execSync } from 'node:child_process'

15import { chmodSync, copyFileSync, existsSync } from 'node:fs'

High

Child Process

Package source references child process execution.

scripts/install.jsView on unpkg · L13

16import { dirname, join } from 'node:path'

17import { fileURLToPath } from 'node:url'

19const INSTALL_URL = 'https://swirls.ai/install'

21const SCRIPT_DIR =

22 typeof import.meta.dir === 'string'

23 ? import.meta.dir

24 : dirname(fileURLToPath(import.meta.url))

26const PACKAGE_ROOT = join(SCRIPT_DIR, '..')

28const INSTALLED_BINARY = join(

29 process.env.HOME || process.env.USERPROFILE || '',

30 '.local',

31 'bin',

32 'swirls',

33)

35const BIN_SWIRLS = join(PACKAGE_ROOT, 'bin', 'swirls')

37if (process.env.CI === 'true' || process.env.CI === '1') {

38 process.exit(0)

Critical

Download Execute

Source downloads or fetches remote code and executes it.

scripts/install.jsView on unpkg · L13

Critical

Trigger Reachable Dangerous Capability

A package entrypoint or install-time lifecycle script reaches a source file with blocking dangerous behavior.

scripts/install.jsView on unpkg · L13

High

Sandbox Evasion Gated Capability

Source gates dangerous network, credential, or execution behavior behind CI, host, platform, time, or geo fingerprint checks.

scripts/install.jsView on unpkg · L13

39}

40if (process.platform === 'win32') {

41 process.exit(0)

42}

43if (!process.env.npm_config_global && !process.env.BUN_INSTALL_GLOBAL) {

44 process.exit(0)

45}

47try {

48 execSync(`curl -fsSL ${INSTALL_URL} | bash`, {

49 stdio: 'inherit',

50 shell: true,

51 })

High

Shell

Package source references shell execution.

scripts/install.jsView on unpkg · L49

52} catch (_err) {

53 process.exit(1)

54}

56if (existsSync(INSTALLED_BINARY)) {

57 copyFileSync(INSTALLED_BINARY, BIN_SWIRLS)

58 chmodSync(BIN_SWIRLS, 0o755)

59}

High

Known Malware Source Similarity

Source file is highly similar to a previously finalized malicious package; route for source-aware review.

scripts/install.jsView on unpkg

High

Known Malware Source Fingerprint Signature

Source fingerprint signature matches a known malicious package signature; route for source-aware review.

scripts/install.jsView on unpkg