registry / handoff-mcp-bridge / 0.2.3
handoff-mcp-bridge@0.2.3
Connects your coding agent to Handoff, and runs it on tasks given to it there (Claude Code, Codex, OpenCode).
AI Security Review
scanned 3d ago · by lpm-firewall-aiThe package has no install-time execution hook, and the flagged configuration writes are confined to a temporary directory during an explicitly invoked runner workflow. The runner sends its Handoff token to the configured Handoff service and launches a coding agent to perform assigned tasks, matching the package’s stated purpose.
Static reason
No blocking static signals were detected.; previous stored version diff introduced dangerous source
Trigger
The runner behavior starts when a user invokes the runner CLI command.
Impact
The agent can edit the selected checkout while handling assigned tasks, as intended by the runner.
Mechanism
It sends authenticated requests to the configured Handoff base URL and creates temporary agent configuration for each task.
AI rationale
The package has no install-time execution hook, and the flagged configuration writes are confined to a temporary directory during an explicitly invoked runner workflow. The runner sends its Handoff token to the configured Handoff service and launches a coding agent to perform assigned tasks, matching the package’s stated purpose.
Evidence
OS temporary directory: handoff-runner-*/mcp.jsonOS temporary directory: handoff-runner-*/opencode.json
Network endpoints2
handoff.olaglover.comConfigured base URL from HANDOFF_URL or saved credentials
Decision evidence
public snapshotAI called this Clean at 94.0% confidence as Benign with low false-positive risk.
Evidence for AI clean decision
- The only lifecycle hook is prepublishOnly, which runs the build; there is no install hook.
- The runner writes agent MCP configuration under a temporary directory and removes that directory when the task ends.
- The bridge takes its Handoff token and server URL from the configured Handoff credentials or environment, then sends the token as bearer authorization to that base URL.
- The runner is an explicit CLI command that starts a selected coding agent to handle Handoff tasks.
Evidence against
- After the runner starts, it automatically claims assigned tasks and launches an agent with edit or full-auto permissions; this is central to the package’s stated purpose.
Behavioral surface
ChildProcessCryptoEnvironmentVarsFilesystemNetwork
HighEntropyStringsUrlStrings
Source & flagged code
5 flaggeddist/runner.jsView file
•Manifest-trigger-reachable source links an external AI-agent control path to a behavior-bearing write operation.
"",
t.instructions,
...(t.next_steps.length ? ["", "steps:", ...t.next_steps.map((s, i) => `${i + 1}. ${s}`)] : []),
...(t.tickets.length ? ["", `issue: ${t.tickets.join(", ")}`] : []),
"",
"how to work:",
`- first call the handoff read_context tool for ${t.repo} with a one-line task, and follow any corrections it returns.`,
`- if the task asks a question or wants an explanation or a review, and doesn't ask you to change code: don't create a branch or commit. write your full answer as your final message; handoff shows it to @${t.from}.`,
`- if you change code: work on the branch ${branch} (check it out, or create it
High
Trigger Reachable External Ai Agent Control Surface Mutation
Manifest-trigger-reachable source writes behavior-bearing configuration into a user or project AI-agent control surface.
dist/runner.jsView on unpkg•matchType = previous_version_dangerous_delta
matchedPackage = handoff-mcp-bridge@0.2.2
matchedIdentity = npm:aGFuZG9mZi1tY3AtYnJpZGdl:0.2.2
similarity = 0.500
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/runner.jsView on unpkgFindings
2 High2 Medium8 Low
HighTrigger Reachable External Ai Agent Control Surface Mutationdist/runner.js
HighPrevious Version Dangerous Deltadist/runner.js
MediumNetwork
MediumEnvironment Vars
LowNon Install Lifecycle Scripts
LowScripts Present
LowFilesystem
LowHigh Entropy Strings
LowUrl Strings
LowSuspicious Lifecycle Evidencepackage.json
LowAi Review Evidencedist/runner.js
LowAi Review Evidencedist/runner.js
Affected versions and remediation
This report applies to handoff-mcp-bridge@0.2.3.
See all versions of handoff-mcp-bridge for other recorded verdicts.
- Review the evidence and your use of handoff-mcp-bridge@0.2.3 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.