@phren/cli 0.0.33 → 0.0.35

package/mcp/dist/hooks.js

@@ -200,6 +200,47 @@ 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 {
+            // File exists but unreadable — don't overwrite, could be a real binary
+            return false;
+        }
+    }
+    const content = `#!/bin/sh
+# PHREN_CLI_WRAPPER — managed by phren init; safe to delete
+set -u
+PHREN_PATH="\${PHREN_PATH:-${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,14 @@ 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
+    const wrapperInstalled = installPhrenCliWrapper(phrenPath);
+    if (wrapperInstalled) {
+        log(`  ${verb} CLI wrapper: ~/.local/bin/phren`);
+    }
+    else {
+        log(`  Note: phren CLI wrapper not installed (existing non-managed binary, or no entry script found)`);
+    }
 }
 export async function runInit(opts = {}) {
     if ((opts.mode || "shared") === "project-local") {
@@ -1956,9 +1964,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/init/setup.js

@@ -6,6 +6,7 @@ import * as path from "path";
 import * as os from "os";
 import * as yaml from "js-yaml";
 import { atomicWriteText, debugLog, findProjectNameCaseInsensitive, hookConfigPath, EXEC_TIMEOUT_QUICK_MS, readRootManifest, sessionsDir, runtimeHealthFile, isRecord, } from "../shared.js";
+import { homePath } from "../phren-paths.js";
 import { addProjectToProfile, listProfiles, resolveActiveProfile, setMachineProfile } from "../profile-store.js";
 import { getMachineName } from "../machine-identity.js";
 import { execFileSync } from "child_process";
@@ -1271,6 +1272,25 @@ export function runPostInitVerify(phrenPath) {
         fix: ftsOk ? undefined : "Create a project: `cd ~/your-project && phren add`",
     });
     checks.push(getHookEntrypointCheck());
+    // Check that the CLI wrapper at ~/.local/bin/phren exists and is executable (soft check — not mandatory)
+    const cliWrapperPath = homePath(".local", "bin", "phren");
+    let cliWrapperOk = false;
+    try {
+        const stat = fs.statSync(cliWrapperPath);
+        cliWrapperOk = stat.isFile();
+        if (cliWrapperOk)
+            fs.accessSync(cliWrapperPath, fs.constants.X_OK);
+    }
+    catch {
+        cliWrapperOk = false;
+    }
+    checks.push({
+        name: "cli-wrapper",
+        ok: true, // always pass — wrapper is optional (global install or npx work too)
+        detail: cliWrapperOk
+            ? `CLI wrapper exists: ${cliWrapperPath}`
+            : `CLI wrapper not found (optional — use 'npm i -g @phren/cli' or 'npx @phren/cli' instead)`,
+    });
     const ok = checks.every((c) => c.ok);
     return { ok, checks };
 }

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.35",
   "description": "Knowledge layer for AI agents. Phren learns and recalls.",
   "type": "module",
   "bin": {