linkshell-cli@0.5.35
Remote terminal bridge for Claude Code / Codex / Gemini / Copilot — control from your phone
AI Security Review
scanned 2mo ago · by lpm-firewall-aiThe package presents a real high-impact remote terminal and AI-agent integration capability, so it merits a warning. Source does not support a malicious block: lifecycle code does not alter AI-agent settings or perform network/exfiltration actions.
Static reason
One or more suspicious static signals were detected.; previous stored version diff introduced dangerous source
Trigger
User runs `linkshell start` (agent UI enabled by default).
Impact
A paired gateway client can receive terminal output and interact with the user-started shell.
Mechanism
temporary AI-agent hook injection and gateway-mediated PTY relay
AI rationale
The package presents a real high-impact remote terminal and AI-agent integration capability, so it merits a warning. Source does not support a malicious block: lifecycle code does not alter AI-agent settings or perform network/exfiltration actions.
Evidence
package.jsonscripts/postinstall.mjsdist/cli/src/index.jsdist/cli/src/runtime/bridge-session.jsdist/cli/src/commands/login.jsdist/cli/src/commands/upgrade.jsdist/cli/src/runtime/acp/provider-resolver.js~/.claude/settings.json~/.codex/config.toml~/.codex/hooks.json~/.gemini/settings.json<working-directory>/hooks.json
Network endpoints1
127.0.0.1
Decision evidence
public snapshotAI called this Suspicious at 90.0% confidence as Dangerous Capability with medium false-positive risk.
Evidence for warning
- `linkshell start` enables the agent UI by default.
- A custom bridge writes hook commands for Claude, Codex, Gemini, and Copilot.
- Codex setup enables hooks and writes shared `~/.codex` configuration.
- PTY output is forwarded to the configured gateway.
Evidence against
- The postinstall hook only chmods existing node-pty helper binaries.
- Agent-config mutation is reached through the explicit `linkshell start` command.
- Hook receiver binds only to 127.0.0.1 and cleanup removes marked entries.
- No install-time network, credential harvesting, remote payload loading, or destructive action was found.
Behavioral surface
ChildProcessCryptoDynamicRequireEnvironmentVarsEvalFilesystemNetworkShellWebSocket
HighEntropyStringsMinifiedPossibleObfuscation
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.35.
See all versions of linkshell-cli for other recorded verdicts.
- Review the evidence and your use of linkshell-cli@0.5.35 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.