trueline-mcp 1.2.0

package/INSTALL.md

@@ -0,0 +1,190 @@
+# Installation
+
+trueline-mcp works with any AI coding agent that speaks MCP. Platform-specific
+hooks bring compliance from ~60% (instruction-only) to ~98% (with hooks).
+
+## Claude Code
+
+Install from the plugin marketplace — no manual configuration needed:
+
+```
+/plugin marketplace add rjkaes/trueline-mcp
+/plugin install trueline-mcp@trueline-mcp
+```
+
+Hooks (`SessionStart`, `PreToolUse`) are registered automatically via the
+plugin's `hooks.json`.
+
+## Gemini CLI
+
+### 1. Add the MCP server
+
+Add to `~/.gemini/settings.json`:
+
+```json
+{
+  "mcpServers": {
+    "trueline": {
+      "command": "npx",
+      "args": ["-y", "trueline-mcp"]
+    }
+  }
+}
+```
+
+### 2. Add the instruction file
+
+Copy `configs/gemini-cli/GEMINI.md` into your project root. This tells the
+agent to prefer trueline tools over built-in `read_file` and `edit_file`.
+
+### 3. Add hooks (optional, recommended)
+
+Install trueline globally so the hook dispatcher is available:
+
+```sh
+npm i -g trueline-mcp
+```
+
+Then add to `~/.gemini/settings.json`:
+
+```json
+{
+  "hooks": {
+    "BeforeTool": [
+      {
+        "command": "trueline-hook gemini-cli beforetool"
+      }
+    ]
+  }
+}
+```
+
+This intercepts `read_file` and `edit_file` calls and redirects them to
+trueline equivalents.
+
+## VS Code Copilot
+
+### 1. Add the MCP server
+
+Add to `.vscode/mcp.json` in your project:
+
+```json
+{
+  "servers": {
+    "trueline": {
+      "command": "npx",
+      "args": ["-y", "trueline-mcp"]
+    }
+  }
+}
+```
+
+### 2. Add the instruction file
+
+Copy `configs/vscode-copilot/copilot-instructions.md` into your project's
+`.github/` directory (or wherever your Copilot instructions live).
+
+### 3. Add hooks (optional, recommended)
+
+Install trueline globally:
+
+```sh
+npm i -g trueline-mcp
+```
+
+Then configure the hook in your VS Code Copilot agent settings to run:
+
+```
+trueline-hook vscode-copilot pretooluse
+```
+
+## OpenCode
+
+### 1. Add the MCP server
+
+Add to your `opencode.json`:
+
+```json
+{
+  "mcp": {
+    "trueline": {
+      "command": "npx",
+      "args": ["-y", "trueline-mcp"]
+    }
+  }
+}
+```
+
+### 2. Add the instruction file
+
+Copy `configs/opencode/AGENTS.md` into your project root. This tells the
+agent to use trueline tools instead of built-in `view` and `edit`.
+
+### 3. Hooks
+
+OpenCode uses in-process TypeScript plugins rather than JSON stdin/stdout
+hooks. Hook support for OpenCode is not yet implemented — the instruction file
+provides ~60% compliance on its own.
+
+## Codex CLI
+
+### 1. Add the MCP server
+
+Add to `~/.codex/config.toml`:
+
+```toml
+[mcp_servers.trueline]
+command = "npx"
+args = ["-y", "trueline-mcp"]
+```
+
+### 2. Add the instruction file
+
+Copy `configs/codex/AGENTS.md` into your project root. This tells the agent
+to use trueline tools instead of `read_file` and `shell cat`.
+
+### 3. Hooks
+
+Codex CLI does not support hooks. The instruction file is the only mechanism
+for tool redirection (~60% compliance).
+
+## CLI hook dispatcher
+
+The `trueline-hook` command is the universal entry point for hook integration:
+
+```
+trueline-hook <platform> <event>
+```
+
+| Platform       | Event          | Description                     |
+|----------------|----------------|---------------------------------|
+| gemini-cli     | beforetool     | Intercept tool calls            |
+| gemini-cli     | session-start  | Inject trueline instructions    |
+| vscode-copilot | pretooluse     | Intercept tool calls            |
+| vscode-copilot | session-start  | Inject trueline instructions    |
+| claude-code    | pretooluse     | Intercept tool calls            |
+| claude-code    | session-start  | Inject trueline instructions    |
+
+Install globally to make it available:
+
+```sh
+npm i -g trueline-mcp
+```
+
+## Path access
+
+By default, trueline tools can access files inside the project directory and
+`~/.claude/`. To allow additional directories, set `TRUELINE_ALLOWED_DIRS` to
+a colon-separated list of paths (semicolon-separated on Windows).
+
+## Platform detection
+
+The hook dispatcher auto-detects the platform from environment variables:
+
+| Env var                | Platform       |
+|------------------------|----------------|
+| `GEMINI_PROJECT_DIR`   | gemini-cli     |
+| `OPENCODE_PROJECT_DIR` | opencode       |
+| `CLAUDE_PROJECT_DIR`   | claude-code    |
+
+Override with `TRUELINE_PLATFORM=<platform>` if auto-detection doesn't work.

package/LICENSE

@@ -0,0 +1,190 @@
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   Copyright 2026 Robert James Kaes
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

package/README.md

@@ -0,0 +1,194 @@
+# trueline-mcp
+
+[![CI](https://github.com/rjkaes/trueline-mcp/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/rjkaes/trueline-mcp/actions/workflows/ci.yml) [![License: Apache-2.0](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE) [![GitHub stars](https://img.shields.io/github/stars/rjkaes/trueline-mcp)](https://github.com/rjkaes/trueline-mcp) [![Last commit](https://img.shields.io/github/last-commit/rjkaes/trueline-mcp)](https://github.com/rjkaes/trueline-mcp/commits/main) [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+
+A [Model Context Protocol](https://modelcontextprotocol.io/) plugin that cuts
+context usage and catches editing mistakes. Works with Claude Code, Gemini CLI,
+VS Code Copilot, OpenCode, and Codex CLI.
+
+## Installation
+
+**Claude Code** (recommended — hooks are automatic):
+
+```
+/plugin marketplace add rjkaes/trueline-mcp
+/plugin install trueline-mcp@trueline-mcp
+```
+
+**Other platforms** (Gemini CLI, VS Code Copilot, OpenCode, Codex CLI):
+See [INSTALL.md](INSTALL.md) for platform-specific setup instructions.
+
+## The problem
+
+AI agents waste tokens in two ways:
+
+1. **Reading too much.** To find a function in a 500-line file, the agent
+   reads all 500 lines — most of which it doesn't need.
+
+2. **Echoing on edit.** The built-in `Edit` tool requires the agent to
+   output the old text being replaced (`old_string`) plus the new text.
+   The old text is pure overhead.
+
+Both problems compound. A typical editing session reads dozens of files
+and makes multiple edits, burning through context on redundant content.
+
+And when things go wrong — stale reads, hallucinated anchors, ambiguous
+matches — the agent silently corrupts your code.
+
+## How trueline fixes this
+
+trueline replaces Claude Code's built-in `Read` and `Edit` with four
+tools that are smaller, faster, and verified.
+
+### 95% fewer input tokens with `trueline_outline`
+
+Instead of reading an entire file to understand its structure,
+`trueline_outline` returns a compact AST outline — just the functions,
+classes, types, and declarations with their line ranges:
+
+```
+1-10: (10 imports)
+12-12: const VERSION = pkg.version;
+14-17: const server = new McpServer({
+25-45: async function resolveAllowedDirs(): Promise<string[]> {
+49-69: server.registerTool(
+71-92: server.registerTool(
+
+(12 symbols, 139 source lines)
+```
+
+12 lines instead of 139. The agent sees the full structure, picks the
+ranges it needs, and reads only those — skipping hundreds of irrelevant
+lines.
+
+| File size   | Full read | Outline | Savings |
+|-------------|-----------|---------|---------|
+| 140 lines   | 140 tokens | 12 tokens | 91% |
+| 245 lines   | 245 tokens | 14 tokens | 94% |
+| 504 lines   | 504 tokens | 4 tokens  | 99% |
+
+Every line range in the outline maps directly to a `trueline_read` call.
+
+Supports 20+ languages: TypeScript, JavaScript, Python, Go, Rust, Java, C,
+C++, C#, Ruby, PHP, Kotlin, Swift, Scala, Elixir, Lua, Dart, Zig, Bash.
+
+### 44% fewer output tokens with `trueline_edit`
+
+The built-in `Edit` makes the model echo back the text being replaced:
+
+```json
+// Built-in Edit — model must output the old text
+{
+  "old_string": "export function handleRequest(req: Request) {\n  ...\n}",
+  "new_string": "export function handleRequest(req: Request) {\n  ...(new)...\n}"
+}
+```
+
+`trueline_edit` replaces old text with a compact line-range reference:
+
+```json
+// trueline_edit — just the range and the new content
+{
+  "edits": [{
+    "checksum": "1-50:a3b1c2d4",
+    "range": "12:kf..16:qz",
+    "content": "export function handleRequest(req: Request) {\n  ...(new)...\n}"
+  }]
+}
+```
+
+The model never echoes old text. For a typical 15-line edit:
+
+| | Built-in Edit | trueline_edit |
+|---|---|---|
+| Old text echoed (output tokens) | ~225 | 0 |
+| New text (output tokens) | ~225 | ~225 |
+| Range/checksum overhead | 0 | ~13 |
+| **Total output tokens** | **~470** | **~263** |
+| **Savings** | | **44%** |
+
+Output tokens are the most expensive token class. Cutting them by 44%
+on every edit adds up fast.
+
+### Targeted reads save more input tokens
+
+`trueline_read` supports multiple disjoint ranges in a single call.
+Instead of re-reading a 2000-line file to edit two distant sections,
+the agent reads only the ranges it needs:
+
+```
+trueline_read(file_path: "big-file.ts", ranges: [{start: 45, end: 60}, {start: 200, end: 215}])
+```
+
+30 lines instead of 2000 — with separate checksums for each range.
+
+### Hash verification catches mistakes
+
+Every line from `trueline_read` carries a content hash. Every edit must
+present those hashes back, proving the agent is working against the
+file's actual content:
+
+```
+1:bx|import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+2:dd|
+3:ew|const server = new Server({ name: "trueline-mcp", version: "0.1.0" });
+
+checksum: 1-3:8a64a3f7
+```
+
+If anything changed since the read — concurrent edits, model
+hallucination, stale context — the edit is rejected before any bytes
+hit disk. Three layers of protection:
+
+| Layer | What it catches |
+|-------|----------------|
+| Per-line hash | Changed content at edit boundaries |
+| Range checksum | Any change within the read window |
+| mtime guard | Concurrent modification by another process |
+
+No more silent corruption. No more ambiguous string matches.
+
+### Batch edits in one call
+
+The built-in `Edit` handles one replacement per call. `trueline_edit`
+accepts an array of edits applied atomically, cutting tool-call
+overhead for multi-site changes.
+
+## Workflow
+
+```
+trueline_outline (navigate)
+    → trueline_read (targeted ranges)
+    → trueline_diff (preview) [optional]
+    → trueline_edit (apply)
+```
+
+A `SessionStart` hook injects instructions directing the agent to use
+trueline tools. A `PreToolUse` hook blocks the built-in `Edit` tool and
+redirects to the trueline workflow. On other platforms, equivalent hooks
+are available via the `trueline-hook` CLI dispatcher — see
+[INSTALL.md](INSTALL.md).
+
+## Path access
+
+By default, trueline tools can access files inside the project directory
+and `~/.claude/`. To allow additional directories, set
+`TRUELINE_ALLOWED_DIRS` to a colon-separated list of paths
+(semicolon-separated on Windows).
+
+## Development
+
+Requires [Bun](https://bun.sh) ≥ 1.3.
+
+```sh
+bun install          # install dependencies
+bun test             # run tests
+bun run build        # build binary for the current platform
+```
+
+## Inspiration
+
+Inspired by [The Harness Problem](https://blog.can.ac/2026/02/12/the-harness-problem/)
+by Can Boluk and the
+[vscode-hashline-edit-tool](https://github.com/sethml/vscode-hashline-edit-tool)
+by Seth Livingston.

package/bin/trueline-hook.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+// ==============================================================================
+// CLI Dispatcher: trueline-hook <platform> <event>
+// ==============================================================================
+//
+// Universal entry point for hook integration on any platform.
+//
+// Usage:
+//   trueline-hook gemini-cli beforetool    # Gemini CLI BeforeTool hook
+//   trueline-hook gemini-cli session-start # Gemini CLI session instructions
+//   trueline-hook vscode-copilot pretooluse
+//   trueline-hook claude-code pretooluse
+//
+// Reads hook event JSON from stdin (for tool-use hooks), writes platform-
+// formatted JSON to stdout.
+
+import { fileURLToPath } from "node:url";
+import { resolve, dirname } from "node:path";
+
+const hooksDir = resolve(dirname(fileURLToPath(import.meta.url)), "..", "hooks");
+
+const USAGE = `Usage: trueline-hook <platform> <event>
+
+Platforms: claude-code, gemini-cli, vscode-copilot
+Events:    pretooluse, beforetool, session-start
+
+Examples:
+  trueline-hook gemini-cli beforetool
+  trueline-hook vscode-copilot pretooluse
+  trueline-hook claude-code session-start`;
+
+// ==============================================================================
+// Argument Parsing
+// ==============================================================================
+
+const platform = process.argv[2];
+const event = process.argv[3];
+
+if (!platform || !event || process.argv.includes("--help") || process.argv.includes("-h")) {
+  console.error(USAGE);
+  process.exit(1);
+}
+
+// Normalize event names across platforms.
+// Gemini calls it "beforetool", Claude Code calls it "pretooluse" — both map
+// to the same routing logic.
+const EVENT_ALIASES = {
+  beforetool: "pretooluse",
+  before_tool: "pretooluse",
+  "session-start": "session-start",
+  sessionstart: "session-start",
+};
+
+const normalizedEvent = EVENT_ALIASES[event.toLowerCase()] ?? event.toLowerCase();
+
+// ==============================================================================
+// Event Dispatch
+// ==============================================================================
+
+if (normalizedEvent === "session-start") {
+  const { getInstructions } = await import(resolve(hooksDir, "core", "instructions.js"));
+  process.stdout.write(getInstructions(platform));
+} else if (normalizedEvent === "pretooluse") {
+  const { createAccessChecker } = await import(resolve(hooksDir, "core", "access.js"));
+  const { routePreToolUse } = await import(resolve(hooksDir, "core", "routing.js"));
+  const { formatDecision } = await import(resolve(hooksDir, "core", "formatters.js"));
+  const { getProjectDir } = await import(resolve(hooksDir, "core", "platform.js"));
+
+  const chunks = [];
+  process.stdin.on("data", (chunk) => chunks.push(chunk));
+  process.stdin.on("end", async () => {
+    let hookEvent;
+    try {
+      hookEvent = JSON.parse(Buffer.concat(chunks).toString());
+    } catch {
+      console.error("trueline-hook: failed to parse JSON from stdin");
+      process.exit(1);
+    }
+
+    const projectDir = getProjectDir(platform);
+    const canAccess = await createAccessChecker(projectDir);
+    const routing = await routePreToolUse(hookEvent.tool_name, hookEvent.tool_input, canAccess);
+    const result = formatDecision(platform, routing);
+
+    if (result !== null) {
+      process.stdout.write(JSON.stringify(result));
+    }
+  });
+} else {
+  console.error(`trueline-hook: unknown event "${event}". Use pretooluse, beforetool, or session-start.`);
+  process.exit(1);
+}

package/bin/trueline-mcp.js

@@ -0,0 +1,20 @@
+#!/usr/bin/env node
+// MCP server entry point for npm distribution.
+// Delegates to resolve-binary.cjs which prefers bun > deno > node.
+//
+// Usage:
+//   npx trueline-mcp              # via npx
+//   trueline-mcp                   # after npm i -g trueline-mcp
+
+import { execFileSync } from "node:child_process";
+import { resolve, dirname } from "node:path";
+import { fileURLToPath } from "node:url";
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const script = resolve(__dirname, "..", "scripts", "resolve-binary.cjs");
+
+try {
+  execFileSync("node", [script, ...process.argv.slice(2)], { stdio: "inherit" });
+} catch (err) {
+  process.exit(err.status ?? 1);
+}