@johannesbraeunig/ghi 0.1.0

package/README.md

@@ -0,0 +1,12 @@
+# @johannesbraeunig/ghi
+
+A GitHub-native issue tracker CLI for AI agents. Drives GitHub Issues and
+GitHub Projects v2 directly, authenticating via the locally installed
+[`gh` CLI](https://cli.github.com/).
+
+```sh
+npm install -D @johannesbraeunig/ghi
+npx ghi --help
+```
+
+Full documentation: https://github.com/johannesbraeunig/ghi

package/bin/ghi.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+"use strict";
+
+const { spawnSync } = require("child_process");
+
+// Maps `${process.platform}-${process.arch}` to the optionalDependency
+// package that ships the matching prebuilt binary.
+const PLATFORM_PACKAGES = {
+  "darwin-arm64": "@johannesbraeunig/ghi-darwin-arm64",
+  "darwin-x64": "@johannesbraeunig/ghi-darwin-x64",
+  "linux-arm64": "@johannesbraeunig/ghi-linux-arm64",
+  "linux-x64": "@johannesbraeunig/ghi-linux-x64",
+  "win32-arm64": "@johannesbraeunig/ghi-win32-arm64",
+  "win32-x64": "@johannesbraeunig/ghi-win32-x64",
+};
+
+function platformKey() {
+  return `${process.platform}-${process.arch}`;
+}
+
+function resolveBinary() {
+  const key = platformKey();
+  const pkg = PLATFORM_PACKAGES[key];
+  if (!pkg) {
+    throw new Error(
+      `ghi does not publish a prebuilt binary for "${key}". ` +
+        `Supported platforms: ${Object.keys(PLATFORM_PACKAGES).join(", ")}.`
+    );
+  }
+
+  const binName = process.platform === "win32" ? "ghi.exe" : "ghi";
+  try {
+    return require.resolve(`${pkg}/bin/${binName}`);
+  } catch (err) {
+    throw new Error(
+      `Could not find the "${pkg}" package for your platform (${key}). ` +
+        `It should have installed automatically as an optionalDependency. Likely causes:\n` +
+        `  - npm/yarn/pnpm was run with --no-optional or --omit=optional\n` +
+        `  - "npm ci" was run against a package-lock.json generated on a different OS/CPU\n` +
+        `  - a very old package manager that doesn't filter optionalDependencies by os/cpu\n` +
+        `  - Yarn Plug'n'Play in "hardened" mode (ghi's platform packages opt into unplugged mode, but this can still occur)\n` +
+        `Try reinstalling with a plain "npm install" (no --no-optional/--omit=optional flags).`
+    );
+  }
+}
+
+let binaryPath;
+try {
+  binaryPath = resolveBinary();
+} catch (err) {
+  console.error(`ghi: ${err.message}`);
+  process.exit(1);
+}
+
+const result = spawnSync(binaryPath, process.argv.slice(2), { stdio: "inherit" });
+
+if (result.error) {
+  console.error(`ghi: failed to launch ${binaryPath}: ${result.error.message}`);
+  process.exit(1);
+}
+
+// result.status is null when the child was killed by a signal (e.g. Ctrl+C
+// during a network call) rather than exiting normally — process.exit(null)
+// would silently report success (exit 0) in that case, which is wrong for a
+// tool other scripts/agents branch on. Forward the signal instead so the
+// parent shell sees the same termination the child actually had.
+if (result.signal) {
+  process.kill(process.pid, result.signal);
+} else {
+  process.exit(result.status ?? 1);
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@johannesbraeunig/ghi",
+  "version": "0.1.0",
+  "description": "A GitHub-native issue tracker CLI for AI agents",
+  "bin": {
+    "ghi": "bin/ghi.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/johannesbraeunig/ghi.git"
+  },
+  "optionalDependencies": {
+    "@johannesbraeunig/ghi-darwin-arm64": "0.1.0",
+    "@johannesbraeunig/ghi-darwin-x64": "0.1.0",
+    "@johannesbraeunig/ghi-linux-arm64": "0.1.0",
+    "@johannesbraeunig/ghi-linux-x64": "0.1.0",
+    "@johannesbraeunig/ghi-win32-arm64": "0.1.0",
+    "@johannesbraeunig/ghi-win32-x64": "0.1.0"
+  }
+}