@golproductions/check 1.1.0 → 1.2.0

package/README.md

@@ -0,0 +1,98 @@
+# Check — Command Firewall for AI Agents
+
+**152 failed commands without Check. 1 with it.** [Read the case study →](https://www.golproductions.com/blog/check-if-url-is-reachable-without-visiting.html)
+
+Check validates every shell command before execution. It catches wrong flags, missing binaries, bad syntax, and unreachable targets — before your AI agent wastes inference retrying them.
+
+## Install
+
+### Claude Code
+
+Add to `.claude/settings.json`:
+
+```json
+{
+  "hooks": {
+    "PreToolUse": [{
+      "matcher": "Bash|PowerShell",
+      "hooks": [{
+        "type": "command",
+        "command": "npx",
+        "args": ["@golproductions/check"]
+      }]
+    }]
+  },
+  "env": { "GOL_CLIENT_ID": "your_key" }
+}
+```
+
+### Gemini CLI / Antigravity
+
+Add to `.gemini/settings.json`:
+
+```json
+{
+  "hooks": {
+    "BeforeTool": [{
+      "type": "command",
+      "command": "npx @golproductions/check",
+      "matcher": ".*",
+      "timeout": 5000
+    }]
+  }
+}
+```
+
+Set `GOL_CLIENT_ID` in your shell environment.
+
+### Cursor
+
+Add to `.cursor/hooks.json`:
+
+```json
+{
+  "version": 1,
+  "hooks": {
+    "beforeShellExecution": [{
+      "command": "npx @golproductions/check"
+    }]
+  }
+}
+```
+
+Set `GOL_CLIENT_ID` in your shell environment.
+
+## What it does
+
+- **Missing binaries** — `gh`, `python3`, `cargo` not installed? Blocked locally, zero API cost.
+- **Wrong flags** — `--yes`, `--namespace-id` on commands that don't accept them.
+- **Bad syntax** — unmatched quotes, trailing backslashes, malformed heredocs.
+- **Unreachable targets** — DNS failures, domains that don't resolve.
+
+Each blocked command is a retry that never happens. Each avoided retry is inference cost you keep.
+
+## How it works
+
+Check reads the command from stdin (passed by the hook system), validates the binary locally, then validates syntax and targets via the Check API. Returns `allow` or `deny` in the format the platform expects. Sub-100ms.
+
+## Pricing
+
+$0.0068 AUD per check. 80 free checks on signup. Credits never expire.
+
+Get your free API key at [golproductions.com/check.html](https://www.golproductions.com/check.html)
+
+## Links
+
+- [Documentation](https://www.golproductions.com/docs-triage-gate.html)
+- [Pricing](https://www.golproductions.com/pricing.html)
+- [Case study: 152 vs 1](https://www.golproductions.com/blog/check-if-url-is-reachable-without-visiting.html)
+- [VS Code extension](https://open-vsx.org/extension/golproductions/gol-check)
+- [FAQ](https://www.golproductions.com/faq.html)
+
+## Also available as
+
+- **CLI** — `curl check.golproductions.com | sh`
+- **VS Code** — `ext install golproductions.gol-check`
+- **Direct API** — `POST https://triage.golproductions.com/preflight`
+
+Copyright (c) 2026 GOL Productions. All rights reserved.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@golproductions/check",
-  "version": "1.1.0",
-  "description": "Pre-execution firewall hook for AI agents. Validates every command before it reaches the shell. Supports Claude Code, Gemini CLI, Antigravity, and Cursor.",
+  "version": "1.2.0",
+  "description": "Pre-execution firewall hook for AI agents. Validates every command before it reaches the shell. 152 failed commands without Check. 1 with it. Supports Claude Code, Gemini CLI, Antigravity, Cursor, and VS Code.",
   "bin": {
     "check": "src/index.js"
   },
@@ -11,7 +11,8 @@
   },
   "files": [
     "src/",
-    "LICENSE"
+    "LICENSE",
+    "README.md"
   ],
   "keywords": [
     "claude-code",
@@ -24,7 +25,10 @@
     "beforeshellexecution",
     "command-validation",
     "firewall",
-    "ai-agents"
+    "ai-agents",
+    "vscode",
+    "openvsx",
+    "windsurf"
   ],
   "license": "SEE LICENSE IN LICENSE",
   "repository": {

package/src/index.js

@@ -3,11 +3,94 @@
 
 import { execFileSync } from "node:child_process";
 
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { homedir } from "node:os";
+
 const API = "https://triage.golproductions.com/preflight";
 const CLIENT_ID = process.env.GOL_CLIENT_ID || "";
 const TIMEOUT_MS = 5000;
 const IS_WIN = process.platform === "win32";
 
+function install() {
+  const key = process.argv[3] || process.env.GOL_CLIENT_ID || "your_key";
+  const home = homedir();
+  let installed = 0;
+
+  const targets = [
+    {
+      name: "Claude Code",
+      dir: join(home, ".claude"),
+      file: "settings.json",
+      config: (existing) => {
+        existing.hooks = existing.hooks || {};
+        existing.hooks.PreToolUse = [{
+          matcher: "Bash|PowerShell",
+          hooks: [{ type: "command", command: "npx", args: ["@golproductions/check"] }]
+        }];
+        existing.env = existing.env || {};
+        existing.env.GOL_CLIENT_ID = key;
+        return existing;
+      }
+    },
+    {
+      name: "Gemini CLI / Antigravity",
+      dir: join(home, ".gemini"),
+      file: "settings.json",
+      config: (existing) => {
+        existing.hooks = existing.hooks || {};
+        existing.hooks.BeforeTool = [{
+          type: "command",
+          command: "npx @golproductions/check",
+          matcher: ".*",
+          timeout: 5000
+        }];
+        return existing;
+      }
+    },
+    {
+      name: "Cursor",
+      dir: join(home, ".cursor"),
+      file: "hooks.json",
+      config: (existing) => {
+        existing.version = existing.version || 1;
+        existing.hooks = existing.hooks || {};
+        existing.hooks.beforeShellExecution = [{
+          command: "npx @golproductions/check"
+        }];
+        return existing;
+      }
+    }
+  ];
+
+  for (const t of targets) {
+    if (!existsSync(t.dir)) continue;
+    const filepath = join(t.dir, t.file);
+    let existing = {};
+    try { existing = JSON.parse(readFileSync(filepath, "utf8")); } catch {}
+    const updated = t.config(existing);
+    mkdirSync(t.dir, { recursive: true });
+    writeFileSync(filepath, JSON.stringify(updated, null, 2) + "\n", "utf8");
+    console.log(`✓ ${t.name} — ${filepath}`);
+    installed++;
+  }
+
+  if (installed === 0) {
+    console.log("No IDE config directories found (~/.claude, ~/.gemini, ~/.cursor).");
+    console.log("Start your IDE first, then run: npx @golproductions/check --install");
+    process.exit(1);
+  }
+
+  console.log(`\n${installed} IDE(s) configured. Restart your IDE to activate Check.`);
+  if (key === "your_key") {
+    console.log("Set your key: export GOL_CLIENT_ID=your_key");
+    console.log("Get a free key at https://www.golproductions.com/check.html");
+  }
+  process.exit(0);
+}
+
+if (process.argv.includes("--install")) { install(); }
+
 const SKIP = new Set(["cd", "ls", "dir", "pwd", "echo", "cat", "head", "tail", "wc", "mkdir", "test", "true", "false", "exit"]);
 const PREFIXES = new Set(["sudo", "nohup", "nice", "time", "timeout", "env"]);