linkshell-cli@0.5.36
Remote terminal bridge for Claude Code / Codex / Gemini / Copilot — control from your phone
AI Security Review
scanned 2mo ago · by lpm-firewall-aiSource confirms an explicit-command AI-agent configuration mutation with a local hook relay, but no unconsented install-time mutation, remote payload execution, or concrete credential theft. Per policy this warrants a warning rather than a publish block.
Static reason
One or more suspicious static signals were detected.; previous stored version diff introduced dangerous source
Trigger
User runs `linkshell start`.
Impact
Later Claude/Codex/Gemini/Copilot hook events are routed through the LinkShell process for remote permission/status handling.
Mechanism
writes AI-agent command hooks that POST events to a localhost server
AI rationale
Source confirms an explicit-command AI-agent configuration mutation with a local hook relay, but no unconsented install-time mutation, remote payload execution, or concrete credential theft. Per policy this warrants a warning rather than a publish block.
Evidence
package.jsonscripts/postinstall.mjssrc/index.tssrc/runtime/bridge-session.tssrc/runtime/hook-command.ts~/.claude/settings.json~/.codex/config.toml~/.codex/hooks.json~/.gemini/settings.jsonhooks.json
Network endpoints1
127.0.0.1
Decision evidence
public snapshotAI called this Suspicious at 91.0% confidence as Dangerous Capability with low false-positive risk.
Evidence for warning
- Explicit `linkshell start` creates hooks for Claude, Codex, Gemini, and Copilot.
- It enables Codex hooks and writes command-hook entries to `~/.codex`.
- Injected hooks POST agent events to a local LinkShell permission server.
Evidence against
- The postinstall script only chmods node-pty helper binaries.
- The control-surface mutation is reached by an explicit CLI start command, not installation.
- Screen capture requires the explicit `--screen` option.
Behavioral surface
ChildProcessCryptoDynamicRequireEnvironmentVarsEvalFilesystemNetworkShellWebSocket
HighEntropyStringsMinifiedPossibleObfuscationUrlStrings
Source & flagged code
12 flaggedpackage.jsonView file
•scripts.postinstall = node scripts/postinstall.mjs
High
Install Time Lifecycle Scripts
Package defines install-time lifecycle scripts.
package.jsonView on unpkg•scripts.postinstall = node scripts/postinstall.mjs
Medium
Ambiguous Install Lifecycle Script
Install-time lifecycle script is not statically allowlisted and needs review.
package.jsonView on unpkgdist/cli/src/runtime/acp-relay.jsView file
1import { spawn } from "node:child_process";
L2: import { createInterface } from "node:readline";
High
Child Process
Package source references child process execution.
dist/cli/src/runtime/acp-relay.jsView on unpkg · L1Findings
1 Critical8 High5 Medium5 Low
CriticalPrevious Version Dangerous Deltadist/cli/src/runtime/acp/provider-resolver.js
HighInstall Time Lifecycle Scriptspackage.json
HighChild Processdist/cli/src/runtime/acp-relay.js
HighShelldist/cli/src/runtime/screen-fallback.js
HighCommand Output Exfiltrationdist/cli/src/commands/login.js
HighCopied Package Dependency Bridgedist/cli/src/commands/doctor.js
HighTrigger Reachable External Ai Agent Control Surface Mutationdist/cli/src/runtime/bridge-session.js
HighTrigger Reachable Command Output Exfiltrationdist/cli/src/commands/login.js
HighRuntime Package Installdist/cli/src/commands/upgrade.js
MediumAmbiguous Install Lifecycle Scriptpackage.json
Affected versions and remediation
This report applies to linkshell-cli@0.5.36.
See all versions of linkshell-cli for other recorded verdicts.
- Review the evidence and your use of linkshell-cli@0.5.36 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: .
Think this verdict is wrong? Dispute it on GitHub or read how reports are produced.