@phren/cli 0.0.33 → 0.0.34

package/mcp/dist/hooks.js

@@ -200,6 +200,44 @@ exit $status
         return false;
     }
 }
+/**
+ * Install a lightweight `phren` CLI wrapper at ~/.local/bin/phren so the bare
+ * `phren` command works without a global npm install. The wrapper simply execs
+ * `node <entry_script> "$@"`.
+ */
+export function installPhrenCliWrapper(phrenPath) {
+    const entry = resolveCliEntryScript();
+    if (!entry)
+        return false;
+    const localBinDir = homePath(".local", "bin");
+    const wrapperPath = path.join(localBinDir, "phren");
+    // Don't overwrite a real global install — only our own wrapper
+    if (fs.existsSync(wrapperPath)) {
+        try {
+            const existing = fs.readFileSync(wrapperPath, "utf8");
+            if (!existing.includes("PHREN_CLI_WRAPPER"))
+                return false;
+        }
+        catch { /* unreadable — skip */ }
+    }
+    const content = `#!/bin/sh
+# PHREN_CLI_WRAPPER — managed by phren init; safe to delete
+set -u
+PHREN_PATH="\${PHREN_PATH:-${shellEscape(phrenPath)}}"
+export PHREN_PATH
+exec node ${shellEscape(entry)} "$@"
+`;
+    try {
+        fs.mkdirSync(localBinDir, { recursive: true });
+        atomicWriteText(wrapperPath, content);
+        fs.chmodSync(wrapperPath, 0o755);
+        return true;
+    }
+    catch (err) {
+        debugLog(`installPhrenCliWrapper: failed: ${errorMessage(err)}`);
+        return false;
+    }
+}
 function validateCopilotConfig(config) {
     return (typeof config.version === "number" &&
         Array.isArray(config.hooks?.sessionStart) &&

package/mcp/dist/init/init.js

@@ -6,7 +6,7 @@ import * as fs from "fs";
 import * as path from "path";
 import * as crypto from "crypto";
 import { execFileSync, spawnSync } from "child_process";
-import { configureAllHooks } from "../hooks.js";
+import { configureAllHooks, installPhrenCliWrapper } from "../hooks.js";
 import { getMachineName, machineFilePath, persistMachineName } from "../machine-identity.js";
 import { atomicWriteText, debugLog, isRecord, hookConfigPath, homeDir, homePath, expandHomePath, findPhrenPath, getProjectDirs, readRootManifest, writeRootManifest, } from "../shared.js";
 import { isValidProjectName, errorMessage } from "../utils.js";
@@ -969,6 +969,15 @@ function configureHooksIfEnabled(phrenPath, hooksEnabled, verb) {
     else {
         log(`  Hooks are disabled by preference (run: npx phren hooks-mode on)`);
     }
+    // Install phren CLI wrapper at ~/.local/bin/phren so the bare command works
+    try {
+        if (installPhrenCliWrapper(phrenPath)) {
+            log(`  ${verb} CLI wrapper: ~/.local/bin/phren`);
+        }
+    }
+    catch (err) {
+        debugLog(`installPhrenCliWrapper failed: ${errorMessage(err)}`);
+    }
 }
 export async function runInit(opts = {}) {
     if ((opts.mode || "shared") === "project-local") {
@@ -1956,9 +1965,9 @@ export async function runUninstall(opts = {}) {
     catch (err) {
         debugLog(`uninstall: cleanup failed for ${codexHooksFile}: ${errorMessage(err)}`);
     }
-    // Remove session wrapper scripts (written by installSessionWrapper)
+    // Remove session wrapper scripts (written by installSessionWrapper) and CLI wrapper
     const localBinDir = path.join(home, ".local", "bin");
-    for (const tool of ["copilot", "cursor", "codex"]) {
+    for (const tool of ["copilot", "cursor", "codex", "phren"]) {
         const wrapperPath = path.join(localBinDir, tool);
         try {
             if (fs.existsSync(wrapperPath)) {

package/mcp/dist/link/doctor.js

@@ -402,6 +402,15 @@ export async function runDoctor(phrenPath, fix = false, checkData = false) {
                 : `${tool} wrapper missing or not first in PATH`,
         });
     }
+    // Check phren CLI wrapper
+    const phrenCliActive = isWrapperActive("phren");
+    checks.push({
+        name: "wrapper:phren-cli",
+        ok: phrenCliActive,
+        detail: phrenCliActive
+            ? "phren CLI wrapper active via ~/.local/bin/phren"
+            : "phren CLI wrapper missing — run init to install, or npm i -g @phren/cli",
+    });
     if (fix) {
         const repaired = repairPreexistingInstall(phrenPath);
         const details = [];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@phren/cli",
-  "version": "0.0.33",
+  "version": "0.0.34",
   "description": "Knowledge layer for AI agents. Phren learns and recalls.",
   "type": "module",
   "bin": {