osx-query 0.1.3 → 0.1.4

package/README.md

@@ -72,14 +72,38 @@ OSX_QUERY_SKIP_SKILLS_PROMPT=1 npm i -g osx-query
 
 ## Troubleshooting
 
-If the install succeeds but `osx` is not found:
+If `npm i -g osx-query` succeeds but `osx` is not found, the usual cause is that your npm global bin directory is not on `PATH`.
+
+Check where npm installs global binaries:
+
+```bash
+npm prefix -g
+npm bin -g
+```
+
+Then make sure that bin directory is on your shell `PATH`.
+
+If `osx` exists but it is the wrong one, check for command shadowing:
 
 ```bash
-hash -r
-which osx
+which -a osx
 ```
 
-If you need to reinstall:
+That will show whether another `osx` binary or symlink is being found before the npm-installed one.
+
+If the command is found but macOS blocks it, verify the installed binary directly:
+
+```bash
+osx --help
+spctl -a -t exec -vv "$(which osx)"
+codesign -dv "$(which osx)" 2>&1 | head
+```
+
+If queries run but return nothing useful, the problem is usually Accessibility permissions, not installation. Grant access to your terminal in:
+
+`System Settings -> Privacy & Security -> Accessibility`
+
+If you want to reinstall cleanly:
 
 ```bash
 npm uninstall -g osx-query

package/lib/install.js

@@ -88,6 +88,7 @@ function installBinary(extractedRoot, vendorDir) {
   fs.mkdirSync(vendorDir, { recursive: true });
   fs.copyFileSync(sourceBinary, targetBinary);
   fs.chmodSync(targetBinary, 0o755);
+  return targetBinary;
 }
 
 function shouldPromptForSkills() {
@@ -166,8 +167,9 @@ async function main() {
     fs.mkdirSync(extractDir, { recursive: true });
 
     extract(zipPath, extractDir);
-    installBinary(extractDir, vendorDir);
-    console.log("Installed osx. Run `osx --help` to get started.");
+    const installedBinary = installBinary(extractDir, vendorDir);
+    console.log(`Installed osx at ${installedBinary}`);
+    console.log("Run `osx --help` to get started.");
     await maybePromptForSkills();
   } finally {
     fs.rmSync(tempDir, { recursive: true, force: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "osx-query",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "osxBinaryVersion": "0.1.2",
   "description": "macOS Accessibility query CLI",
   "license": "MIT",