llmignore-cli 0.1.0

package/README.md

@@ -0,0 +1,14 @@
+# llmignore
+
+Like `.gitignore`, but it tells AI tools (Claude Code, Cursor, Copilot, ...) what **not** to read.
+
+```bash
+npx llmignore-cli init     # write a .llmignore with strong defaults
+npx llmignore-cli scan     # any secrets currently exposed to AI? (exit 1 if yes)
+npx llmignore-cli sync     # mirror it into .cursorignore, .aiexclude, ...
+```
+
+This package (`llmignore-cli`) installs a small native binary (built in Rust) for your
+platform on first use. The installed command is `llmignore`.
+
+Full docs: https://github.com/horiastanxd/llmignore

package/bin/cli.js

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+"use strict";
+
+// Thin launcher: ensures the native binary exists (downloading it on first run if a
+// postinstall was skipped), then forwards all arguments to it and mirrors its exit code.
+
+const fs = require("fs");
+const path = require("path");
+const { spawnSync } = require("child_process");
+
+const bin = path.join(
+  __dirname,
+  process.platform === "win32" ? "llmignore.exe" : "llmignore"
+);
+
+if (!fs.existsSync(bin)) {
+  const install = spawnSync(process.execPath, [path.join(__dirname, "install.js")], {
+    stdio: "inherit",
+  });
+  if (install.status !== 0) {
+    process.exit(install.status || 1);
+  }
+}
+
+const run = spawnSync(bin, process.argv.slice(2), { stdio: "inherit" });
+if (run.error) {
+  console.error(`[llmignore] failed to run binary: ${run.error.message}`);
+  process.exit(1);
+}
+process.exit(run.status === null ? 1 : run.status);

package/bin/install.js

@@ -0,0 +1,87 @@
+#!/usr/bin/env node
+"use strict";
+
+// Downloads the correct prebuilt llmignore binary from GitHub Releases and places
+// it next to this script. Runs on `npm install` (postinstall) and, as a fallback,
+// is invoked by cli.js the first time the binary is missing.
+
+const fs = require("fs");
+const path = require("path");
+const https = require("https");
+const { execFileSync } = require("child_process");
+
+const pkg = require("../package.json");
+const REPO = "horiastanxd/llmignore";
+const VERSION = pkg.version;
+
+const TARGETS = {
+  "linux-x64": "x86_64-unknown-linux-musl",
+  "linux-arm64": "aarch64-unknown-linux-musl",
+  "darwin-x64": "x86_64-apple-darwin",
+  "darwin-arm64": "aarch64-apple-darwin",
+  "win32-x64": "x86_64-pc-windows-msvc",
+};
+
+function resolveTarget() {
+  const key = `${process.platform}-${process.arch}`;
+  const target = TARGETS[key];
+  if (!target) {
+    throw new Error(
+      `unsupported platform "${key}". Install with: cargo install llmignore`
+    );
+  }
+  return target;
+}
+
+function binName() {
+  return process.platform === "win32" ? "llmignore.exe" : "llmignore";
+}
+
+function download(url, dest) {
+  return new Promise((resolve, reject) => {
+    https
+      .get(url, { headers: { "User-Agent": "llmignore-installer" } }, (res) => {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          res.resume();
+          return download(res.headers.location, dest).then(resolve, reject);
+        }
+        if (res.statusCode !== 200) {
+          res.resume();
+          return reject(new Error(`HTTP ${res.statusCode} for ${url}`));
+        }
+        const file = fs.createWriteStream(dest);
+        res.pipe(file);
+        file.on("finish", () => file.close(() => resolve()));
+        file.on("error", reject);
+      })
+      .on("error", reject);
+  });
+}
+
+async function main() {
+  const target = resolveTarget();
+  const ext = process.platform === "win32" ? "zip" : "tar.gz";
+  const asset = `llmignore-${target}.${ext}`;
+  const url = `https://github.com/${REPO}/releases/download/v${VERSION}/${asset}`;
+  const dir = __dirname;
+  const archive = path.join(dir, asset);
+
+  await download(url, archive);
+  // bsdtar (default `tar` on Linux, macOS and Windows 10+) extracts both .tar.gz and .zip.
+  execFileSync("tar", ["-xf", archive, "-C", dir], { stdio: "inherit" });
+  fs.unlinkSync(archive);
+
+  const bin = path.join(dir, binName());
+  if (!fs.existsSync(bin)) {
+    throw new Error("binary not found in archive after extraction");
+  }
+  if (process.platform !== "win32") {
+    fs.chmodSync(bin, 0o755);
+  }
+}
+
+main().catch((err) => {
+  console.error(`[llmignore] could not install the prebuilt binary: ${err.message}`);
+  console.error("[llmignore] alternative: cargo install llmignore");
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "llmignore-cli",
+  "version": "0.1.0",
+  "description": "Like .gitignore, but tells AI tools what NOT to read. Fast native scanner for .llmignore files.",
+  "keywords": [
+    "ai",
+    "llm",
+    "gitignore",
+    "llmignore",
+    "cursor",
+    "claude",
+    "copilot",
+    "cli",
+    "secrets",
+    "context"
+  ],
+  "homepage": "https://github.com/horiastanxd/llmignore#readme",
+  "bugs": {
+    "url": "https://github.com/horiastanxd/llmignore/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/horiastanxd/llmignore.git"
+  },
+  "license": "MIT",
+  "author": "horiastanxd",
+  "bin": {
+    "llmignore": "bin/cli.js"
+  },
+  "scripts": {
+    "postinstall": "node bin/install.js"
+  },
+  "files": [
+    "bin/cli.js",
+    "bin/install.js"
+  ],
+  "engines": {
+    "node": ">=16"
+  },
+  "os": [
+    "linux",
+    "darwin",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ]
+}