@gi4nks/ph 1.6.0 → 1.7.0

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [1.7.0](https://github.com/gi4nks/ph/compare/v1.6.0...v1.7.0) (2026-10-18)
+
+
+### Features
+
+* integrate Wise providers in ph ([4f8094e](https://github.com/gi4nks/ph/commit/4f8094e506430f43a96eaca299c6fc85a65870a9))
+
 # [1.6.0](https://github.com/gi4nks/ph/compare/v1.5.0...v1.6.0) (2026-10-09)
 
 

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Gianluca
+Copyright (c) 2026 gi4nks
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -7,9 +7,10 @@
 - Captures conversations through a transparent command wrapper, native hooks, direct logging, or history import.
 - Searches prompts and responses with SQLite FTS5, or searches by semantic similarity with Ollama embeddings and sqlite-vec.
 - Groups records by project, tool, language, role, tags, time, and quality metadata.
-- Builds project summaries and an append-only analysis history with optional Ollama or Gemini analysis.
+- Builds project summaries and an append-only analysis history with Ollama, Gemini, OpenRouter, or MLX-Serve through `@gi4nks/wise`.
 - Exposes prompt history and project knowledge through an MCP server over stdio.
 - Provides an interactive terminal browser for filtering, reviewing, editing metadata, starring, exporting, and rerunning prompts.
+- The TUI `p` action sends the selected prompt to a configured Wise analysis provider; `r` reruns it with its original CLI tool.
 - Supports optional HTTP sync between a local database and a remote `ph` server.
 
 ## Install
@@ -30,7 +31,7 @@ npm run build
 npm link
 ```
 
-Requires Node.js 20 or later. Ollama is optional; it is used for local analysis and semantic embeddings. Gemini can be used for analysis when configured.
+Requires Node.js 22 or later (the Wise/AI SDK provider stack requires Node 22). Ollama is optional; it is used for local analysis and semantic embeddings. Gemini can be used for analysis when configured.
 
 ## Quick start
 
@@ -121,6 +122,40 @@ ph config set analyze-provider gemini
 ph config set gemini-api-key "$GEMINI_API_KEY"
 ```
 
+For OpenRouter, use the environment or enter the key through ph's hidden prompt, then select an exact model ID:
+
+```bash
+export OPENROUTER_API_KEY="your_openrouter_api_key"
+ph models openrouter
+ph config set openrouter-api-key        # prompts securely; stored in ~/.ph_config.json
+ph config set analyze-provider openrouter
+ph config set openrouter-model "provider/model-id"
+ph config show                         # shows active settings, redacts keys
+ph analyze
+```
+
+For MLX-Serve on Parmenide, open an SSH tunnel to its API port (11234 by default),
+then select an ID returned by the server. Keep the tunnel running in a separate terminal:
+
+```bash
+# Terminal 1
+ssh -N -L 11234:127.0.0.1:11234 parmenide
+```
+
+```bash
+# Terminal 2
+ph models mlx-serve
+ph config set analyze-provider mlx-serve
+ph config set mlx-serve-model "exact-model-id-from-server"
+ph analyze
+```
+
+The MLX-Serve URL defaults to `http://127.0.0.1:11234/v1`; override it with
+`MLX_SERVE_BASE_URL` or `ph config set mlx-serve-url <url>`. If the server requires
+authentication, set `MLX_SERVE_API_KEY` or run `ph config set mlx-serve-api-key`
+for a hidden prompt. `ph config show` redacts credentials. The model catalog
+marks installed models as `[loaded]` or `[unloaded]`.
+
 Project summaries merge deduplicated insights and technical decisions. Individual analysis results remain in an append-only memory timeline. Analysis and embeddings require the corresponding provider to be available; basic capture and full-text search do not.
 
 ## MCP integration
@@ -160,9 +195,13 @@ Configuration is stored in `~/.ph_config.json`; the database defaults to `~/.pro
 | Setting | Default | Purpose |
 |---|---|---|
 | `db-path` | `~/.prompt_history.db` | SQLite database location |
-| `analyze-provider` | `ollama` | Analysis provider: `ollama` or `gemini` |
+| `analyze-provider` | `ollama` | Analysis provider: `ollama`, `gemini`, `openrouter`, or `mlx-serve` |
 | `ollama-url` | `http://localhost:11434` | Ollama endpoint |
 | `ollama-model` | `llama3.1:latest` | Analysis model |
+| `openrouter-model` | unset | Exact OpenRouter model ID, including its provider prefix |
+| `openrouter-url` | `https://openrouter.ai/api/v1` | OpenRouter-compatible API root |
+| `mlx-serve-model` | unset | Exact model ID returned by MLX-Serve |
+| `mlx-serve-url` | `http://127.0.0.1:11234/v1` | MLX-Serve API root, normally the Parmenide SSH tunnel |
 | `ollama-embed-model` | `nomic-embed-text-v2-moe` | Embedding model; current schema expects 768 dimensions |
 | `background-analysis` | `false` | Analyze newly captured prompts asynchronously |
 | `filter-min-length` | `15` | Minimum prompt length accepted by filtering |
@@ -170,6 +209,11 @@ Configuration is stored in `~/.ph_config.json`; the database defaults to `~/.pro
 | `remote-url` | unset | Remote `ph` server; `PH_REMOTE_URL` takes precedence |
 | `remote-api-key` | unset | Optional server authentication key |
 
+Provider credentials can be stored in `~/.ph_config.json` through the hidden
+`ph config set <provider>-api-key` prompts or supplied through environment
+variables. Environment values take precedence; MLX-Serve also accepts the
+existing `GLB_OMLX_API_KEY` variable.
+
 ## Development
 
 ```bash

package/dist/cli.js

@@ -21,6 +21,7 @@ function load() {
 }
 function save(cfg) {
   fs.writeFileSync(CONFIG_PATH, JSON.stringify(cfg, null, 2), { mode: 384 });
+  fs.chmodSync(CONFIG_PATH, 384);
 }
 
 // src/db/index.ts
@@ -2231,10 +2232,13 @@ import { AppHeader, THEMES } from "@gi4nks/ink";
 // package.json
 var package_default = {
   name: "@gi4nks/ph",
-  version: "1.5.0",
+  version: "1.6.0",
   description: "Transparent CLI wrapper that captures and indexes AI prompts",
   type: "module",
   license: "MIT",
+  engines: {
+    node: ">=22"
+  },
   bin: {
     ph: "dist/cli.js"
   },
@@ -2287,8 +2291,10 @@ var package_default = {
   },
   dependencies: {
     "@gi4nks/ink": "^1.5.0",
+    "@gi4nks/wise": "^2.1.0",
     "@lydell/node-pty": "^1.2.0-beta.3",
     "@modelcontextprotocol/sdk": "^1.29.0",
+    ai: "^7.0.136",
     "better-sqlite3": "^12.8.0",
     ink: "^7.0.5",
     react: "^19.2.7",
@@ -2385,7 +2391,7 @@ var Footer = ({
     );
     if (hasProject2) base.push({ key: "C", description: "chat" });
     base.push({ key: "r", description: "rerun" });
-    base.push({ key: "p", description: "provider" });
+    base.push({ key: "p", description: "model" });
     base.push("|");
     base.push(
       { key: "x", description: "del" },
@@ -3062,6 +3068,52 @@ var PreviewPane = ({
   )), /* @__PURE__ */ React6.createElement(Text5, { dimColor: true }, topIndicator), paddedLines.map((line, i) => /* @__PURE__ */ React6.createElement(Text5, { key: i }, line.segments.length > 0 ? line.segments.map((seg, j) => /* @__PURE__ */ React6.createElement(Text5, { key: j, color: seg.color, dimColor: seg.dim }, seg.text)) : " ")), /* @__PURE__ */ React6.createElement(Text5, { dimColor: true }, botIndicator));
 };
 
+// src/config/provider-summary.ts
+function getProviderSummaries(cfg) {
+  const active = cfg.analyzeProvider ?? "ollama";
+  return [
+    {
+      id: "ollama",
+      label: "Ollama",
+      model: cfg.ollamaModel ?? "llama3.1:latest",
+      url: cfg.ollamaUrl ?? "http://localhost:11434",
+      credential: "not required",
+      active: active === "ollama",
+      ready: true
+    },
+    {
+      id: "gemini",
+      label: "Gemini",
+      model: "gemini-2.5-flash",
+      url: "(default)",
+      credential: process.env.GEMINI_API_KEY || cfg.geminiApiKey ? "configured" : "not set",
+      active: active === "gemini",
+      ready: Boolean(process.env.GEMINI_API_KEY || cfg.geminiApiKey)
+    },
+    {
+      id: "openrouter",
+      label: "OpenRouter",
+      model: process.env.OPENROUTER_MODEL ?? cfg.openrouterModel ?? "(not set)",
+      url: process.env.OPENROUTER_BASE_URL ?? cfg.openrouterUrl ?? "https://openrouter.ai/api/v1",
+      credential: process.env.OPENROUTER_API_KEY || cfg.openrouterApiKey ? "configured" : "not set",
+      active: active === "openrouter",
+      ready: Boolean((process.env.OPENROUTER_API_KEY || cfg.openrouterApiKey) && (process.env.OPENROUTER_MODEL || cfg.openrouterModel))
+    },
+    {
+      id: "mlx-serve",
+      label: "MLX-Serve",
+      model: process.env.MLX_SERVE_MODEL ?? cfg.mlxServeModel ?? "(not set)",
+      url: process.env.MLX_SERVE_BASE_URL ?? cfg.mlxServeUrl ?? "http://127.0.0.1:11234/v1",
+      credential: process.env.MLX_SERVE_API_KEY || process.env.GLB_OMLX_API_KEY || cfg.mlxServeApiKey ? "configured" : "not required",
+      active: active === "mlx-serve",
+      ready: Boolean(process.env.MLX_SERVE_MODEL || cfg.mlxServeModel)
+    }
+  ];
+}
+function formatProviderSummary(provider) {
+  return `${provider.active ? "*" : " "} ${provider.label}: model=${provider.model}, url=${provider.url}, key=${provider.credential}, setup=${provider.ready ? "ready" : "incomplete"}`;
+}
+
 // src/ui/BrowseApp.tsx
 function copyToClipboard(text) {
   try {
@@ -3254,33 +3306,26 @@ var RerunView = ({ entry, onConfirm, onClose, theme }) => {
   });
   return /* @__PURE__ */ React7.createElement(Box5, { flexDirection: "column", padding: 1 }, /* @__PURE__ */ React7.createElement(Box5, { marginBottom: 1 }, /* @__PURE__ */ React7.createElement(Text6, { color: theme.primary, bold: true }, "Rerun Prompt #", entry.id)), /* @__PURE__ */ React7.createElement(Box5, { flexDirection: "column", marginBottom: 1 }, /* @__PURE__ */ React7.createElement(Text6, { dimColor: true }, "Tool:      ", /* @__PURE__ */ React7.createElement(Text6, { color: theme.warning }, entry.tool)), /* @__PURE__ */ React7.createElement(Text6, { dimColor: true }, "Date:      ", /* @__PURE__ */ React7.createElement(Text6, null, formatTimestamp2(entry.timestamp))), meta.project && /* @__PURE__ */ React7.createElement(Text6, { dimColor: true }, "Project:   ", /* @__PURE__ */ React7.createElement(Text6, { color: theme.accent }, meta.project)), git && /* @__PURE__ */ React7.createElement(Text6, { dimColor: true }, "Git:       ", /* @__PURE__ */ React7.createElement(Text6, { color: theme.warning }, "Captured on branch: ", git.branch, ", ", git.files?.length || 0, " files modified"))), /* @__PURE__ */ React7.createElement(Box5, { flexDirection: "column", borderStyle: "single", borderColor: theme.dim, padding: 1 }, /* @__PURE__ */ React7.createElement(Box5, { marginBottom: 1 }, /* @__PURE__ */ React7.createElement(Text6, { dimColor: true }, "Tool:   "), /* @__PURE__ */ React7.createElement(Text6, { color: field === "tool" ? theme.primary : "white", bold: field === "tool" }, toolValue, field === "tool" ? "\u2588" : "")), /* @__PURE__ */ React7.createElement(Box5, { flexDirection: "column" }, /* @__PURE__ */ React7.createElement(Text6, { dimColor: true }, "Prompt: "), /* @__PURE__ */ React7.createElement(Box5, { borderStyle: "round", borderColor: field === "prompt" ? theme.primary : theme.dim, paddingX: 1 }, /* @__PURE__ */ React7.createElement(Text6, { color: field === "prompt" ? theme.primary : "white" }, promptValue, field === "prompt" ? "\u2588" : "")))), /* @__PURE__ */ React7.createElement(Box5, { marginTop: 1 }, /* @__PURE__ */ React7.createElement(Text6, { dimColor: true }, "Tab switch \xB7 Enter run \xB7 ESC cancel")));
 };
-var KNOWN_PROVIDERS = [
-  { key: "1", label: "claude", tool: "claude" },
-  { key: "2", label: "gemini", tool: "gemini" },
-  { key: "3", label: "opencode", tool: "opencode" },
-  { key: "4", label: "codex", tool: "codex" },
-  { key: "5", label: "ollama", tool: "ollama" },
-  { key: "6", label: "chatgpt", tool: "chatgpt" }
-];
 var ProviderPicker = ({ entry, onPick, onClose, theme }) => {
+  const providers = getProviderSummaries(load());
   useInput3((char) => {
     if (char === "q" || char === "\x1B") {
       onClose();
       return;
     }
-    const provider = KNOWN_PROVIDERS.find((p) => p.key === char);
-    if (provider) {
-      onPick(provider.tool, entry.prompt);
+    const index = Number(char) - 1;
+    const provider = providers[index];
+    if (provider?.ready) {
+      onPick(`wise:${provider.id}`, entry.prompt);
     }
   });
-  return /* @__PURE__ */ React7.createElement(Box5, { flexDirection: "column", padding: 2 }, /* @__PURE__ */ React7.createElement(Text6, { bold: true, color: theme.primary }, "Send prompt #", entry.id, " to:"), /* @__PURE__ */ React7.createElement(Box5, { marginTop: 1, flexDirection: "column" }, KNOWN_PROVIDERS.map((p) => /* @__PURE__ */ React7.createElement(Text6, { key: p.key }, /* @__PURE__ */ React7.createElement(Text6, { color: theme.warning }, p.key), /* @__PURE__ */ React7.createElement(Text6, null, ": ", p.label)))), /* @__PURE__ */ React7.createElement(Box5, { marginTop: 1 }, /* @__PURE__ */ React7.createElement(Text6, { dimColor: true }, "Pick a number \xB7 q to cancel")));
+  return /* @__PURE__ */ React7.createElement(Box5, { flexDirection: "column", padding: 2 }, /* @__PURE__ */ React7.createElement(Text6, { bold: true, color: theme.primary }, "Run prompt #", entry.id, " with an analysis provider:"), /* @__PURE__ */ React7.createElement(Box5, { marginTop: 1, flexDirection: "column" }, providers.map((provider, index) => /* @__PURE__ */ React7.createElement(Text6, { key: provider.id, color: provider.ready ? "white" : theme.dim }, /* @__PURE__ */ React7.createElement(Text6, { color: provider.ready ? theme.warning : theme.dim }, provider.ready ? index + 1 : " "), /* @__PURE__ */ React7.createElement(Text6, null, ": ", formatProviderSummary(provider).trim())))), /* @__PURE__ */ React7.createElement(Box5, { marginTop: 1 }, /* @__PURE__ */ React7.createElement(Text6, { dimColor: true }, "Pick a configured provider \xB7 q to cancel \xB7 r reruns with the original CLI tool")));
 };
 var SETTING_FIELDS = [
   { key: "backgroundAnalysis", label: "Auto-analysis on capture", type: "boolean" },
   { key: "ollamaUrl", label: "Ollama URL", type: "string" },
   { key: "ollamaModel", label: "Ollama model (analysis)", type: "string" },
   { key: "ollamaEmbedModel", label: "Ollama model (embeddings)", type: "string" },
-  { key: "analyzeProvider", label: "Analysis provider", type: "string" },
   { key: "filterMinLength", label: "Min prompt length filter", type: "number" },
   { key: "filterMinRelevance", label: "Min relevance filter", type: "number" }
 ];
@@ -3327,7 +3372,7 @@ var SettingsView = ({ onClose, theme }) => {
       }
     }
   });
-  return /* @__PURE__ */ React7.createElement(Box5, { flexDirection: "column", padding: 1 }, /* @__PURE__ */ React7.createElement(Box5, { marginBottom: 1 }, /* @__PURE__ */ React7.createElement(Text6, { color: theme.primary, bold: true }, "Settings  "), dirty && /* @__PURE__ */ React7.createElement(Text6, { color: theme.warning }, "modified  "), saved && /* @__PURE__ */ React7.createElement(Text6, { color: theme.success }, "\u2713 saved")), /* @__PURE__ */ React7.createElement(Box5, { borderStyle: "single", borderColor: theme.dim, flexDirection: "column", padding: 1 }, SETTING_FIELDS.map((field, i) => {
+  return /* @__PURE__ */ React7.createElement(Box5, { flexDirection: "column", padding: 1 }, /* @__PURE__ */ React7.createElement(Box5, { marginBottom: 1 }, /* @__PURE__ */ React7.createElement(Text6, { color: theme.primary, bold: true }, "Settings  "), dirty && /* @__PURE__ */ React7.createElement(Text6, { color: theme.warning }, "modified  "), saved && /* @__PURE__ */ React7.createElement(Text6, { color: theme.success }, "\u2713 saved")), /* @__PURE__ */ React7.createElement(Box5, { borderStyle: "single", borderColor: theme.dim, flexDirection: "column", padding: 1 }, /* @__PURE__ */ React7.createElement(Text6, { bold: true, color: theme.primary }, "Analysis providers (* = active; edit with `ph config set`)"), getProviderSummaries(cfg).map((provider) => /* @__PURE__ */ React7.createElement(Text6, { key: provider.id, color: provider.active ? theme.success : theme.dim }, formatProviderSummary(provider))), /* @__PURE__ */ React7.createElement(Text6, null, " "), SETTING_FIELDS.map((field, i) => {
     const isCur = i === cursor;
     const val = cfg[field.key];
     let display;
@@ -4946,9 +4991,87 @@ var GeminiProvider = class {
   }
 };
 
+// src/ai/wise.ts
+import { generateText } from "ai";
+import { createAIModel } from "@gi4nks/wise";
+var OPENROUTER_DEFAULT_URL = "https://openrouter.ai/api/v1";
+var MLX_SERVE_DEFAULT_URL = "http://127.0.0.1:11234/v1";
+var WiseLLMProvider = class {
+  name;
+  model;
+  constructor(wiseProvider, displayName, modelId, config) {
+    this.name = `${displayName} (${modelId})`;
+    this.model = createAIModel(wiseProvider, modelId, config);
+  }
+  async generate(prompt) {
+    const result = await generateText({
+      model: this.model,
+      prompt,
+      // OpenRouter requests can incur cost. Avoid hidden automatic replays.
+      maxRetries: 0
+    });
+    return result.text;
+  }
+};
+async function discoverModels(provider, apiKey, baseUrl) {
+  if (provider === "mlx-serve") {
+    const url2 = (baseUrl || MLX_SERVE_DEFAULT_URL).replace(/\/+$/, "");
+    const response2 = await fetch(`${url2}/models`, {
+      headers: { Authorization: `Bearer ${apiKey}` },
+      signal: AbortSignal.timeout(15e3)
+    });
+    if (!response2.ok) throw new Error(`HTTP ${response2.status}`);
+    const data2 = await response2.json();
+    return (data2.data ?? []).filter((model) => typeof model.id === "string" && model.id.length > 0).map((model) => ({ id: model.id, name: model.name || model.id, loaded: model.loaded, state: model.state }));
+  }
+  const url = (baseUrl || OPENROUTER_DEFAULT_URL).replace(/\/+$/, "");
+  const response = await fetch(`${url}/models`, {
+    headers: { Authorization: `Bearer ${apiKey}` },
+    signal: AbortSignal.timeout(15e3)
+  });
+  if (!response.ok) {
+    throw new Error(`HTTP ${response.status}`);
+  }
+  const data = await response.json();
+  return (data.data ?? []).filter((model) => typeof model.id === "string" && model.id.length > 0).map((model) => ({ id: model.id, name: model.name || model.id }));
+}
+
 // src/ai/provider.ts
-function getProvider(cfg) {
-  const provider = cfg.analyzeProvider ?? "ollama";
+function getProviderSetupError(cfg, selectedProvider) {
+  const provider = selectedProvider ?? cfg.analyzeProvider ?? "ollama";
+  if (provider === "openrouter") {
+    if (!(process.env.OPENROUTER_API_KEY || cfg.openrouterApiKey)) return "Set a key with `ph config set openrouter-api-key` or OPENROUTER_API_KEY.";
+    if (!(process.env.OPENROUTER_MODEL || cfg.openrouterModel)) return "Choose a model with `ph config set openrouter-model <provider/model>`.";
+  }
+  if (provider === "mlx-serve" && !(process.env.MLX_SERVE_MODEL || cfg.mlxServeModel)) {
+    return "Choose an MLX-Serve model with `ph config set mlx-serve-model <model-id>`.";
+  }
+  return null;
+}
+function getProvider(cfg, selectedProvider) {
+  const provider = selectedProvider ?? cfg.analyzeProvider ?? "ollama";
+  if (provider === "openrouter") {
+    const apiKey = process.env.OPENROUTER_API_KEY ?? cfg.openrouterApiKey;
+    const model = process.env.OPENROUTER_MODEL ?? cfg.openrouterModel;
+    if (!apiKey || !model) return null;
+    return new WiseLLMProvider("openai", "OpenRouter", model, {
+      openai: {
+        apiKey,
+        baseUrl: process.env.OPENROUTER_BASE_URL ?? cfg.openrouterUrl ?? OPENROUTER_DEFAULT_URL
+      }
+    });
+  }
+  if (provider === "mlx-serve") {
+    const model = process.env.MLX_SERVE_MODEL ?? cfg.mlxServeModel;
+    if (!model) return null;
+    const apiKey = process.env.MLX_SERVE_API_KEY ?? process.env.GLB_OMLX_API_KEY ?? cfg.mlxServeApiKey ?? "local";
+    return new WiseLLMProvider("omlx", "MLX-Serve", model, {
+      omlx: {
+        apiKey,
+        baseUrl: process.env.MLX_SERVE_BASE_URL ?? cfg.mlxServeUrl ?? MLX_SERVE_DEFAULT_URL
+      }
+    });
+  }
   if (provider === "gemini") {
     const apiKey = process.env.GEMINI_API_KEY ?? cfg.geminiApiKey;
     if (!apiKey) return null;
@@ -4979,7 +5102,9 @@ async function cmdImport(db, cfg, args) {
   if (analyze) {
     analyzer = getProvider(cfg);
     if (!analyzer) {
-      process.stderr.write("ph: no LLM provider configured. Run: ph config set analyze-provider ollama\n");
+      const detail = getProviderSetupError(cfg) ?? "No LLM provider is configured. Run: ph config set analyze-provider ollama";
+      process.stderr.write(`ph: ${detail}
+`);
       process.exit(1);
     }
     console.log(`Analyzing with ${analyzer.name} during import...`);
@@ -5052,7 +5177,9 @@ async function cmdAnalyze(db, cfg, args) {
   const pruneBelow = prune ? flags["min-score"] ? Number(flags["min-score"]) : cfg.filterMinRelevance ?? 3 : 0;
   const provider = getProvider(cfg);
   if (!provider) {
-    process.stderr.write("ph: no LLM provider configured. Set analyze-provider in config.\n");
+    const detail = getProviderSetupError(cfg) ?? "No LLM provider is configured. Set analyze-provider in config.";
+    process.stderr.write(`ph: ${detail}
+`);
     process.exit(1);
   }
   const allRows = db.search({ limit: 1e4 });
@@ -5206,17 +5333,29 @@ async function pushToRemote(url, apiKey, entry) {
 }
 
 // src/commands/config.ts
-function cmdConfig(args) {
-  if (args.length < 3 || args[0] !== "set") {
-    console.log("Usage: ph config set <key> <value>");
+var SECRET_KEYS = ["gemini-api-key", "openrouter-api-key", "mlx-serve-api-key", "remote-api-key"];
+async function cmdConfig(args) {
+  if (args[0] === "show") {
+    const cfg2 = load();
+    console.log("Analysis providers (* = active; credentials are never shown):");
+    for (const provider of getProviderSummaries(cfg2)) console.log(formatProviderSummary(provider));
+    console.log("Configure with: ph config set analyze-provider <ollama|gemini|openrouter|mlx-serve>");
+    return;
+  }
+  if (args[0] !== "set" || args.length < 2) {
+    console.log("Usage: ph config show | ph config set <key> [value]");
     console.log("Keys: gemini-api-key, db-path, analyze-provider, ollama-url, ollama-model,");
+    console.log("      openrouter-model, openrouter-url, openrouter-api-key,");
+    console.log("      mlx-serve-model, mlx-serve-url, mlx-serve-api-key,");
     console.log("      ollama-embed-model, filter-min-length, filter-min-relevance, background-analysis,");
     console.log("      remote-url, remote-api-key");
-    process.exit(1);
+    return;
   }
   const cfg = load();
   const key = args[1];
-  const val = args[2];
+  let val = args.slice(2).join(" ");
+  if (!val && SECRET_KEYS.includes(key)) val = await readSecret(`${key}: `);
+  if (!val) throw new Error(`A value is required for ${key}.`);
   switch (key) {
     case "gemini-api-key":
       cfg.geminiApiKey = val;
@@ -5225,10 +5364,7 @@ function cmdConfig(args) {
       cfg.dbPath = val;
       break;
     case "analyze-provider":
-      if (val !== "ollama" && val !== "gemini") {
-        process.stderr.write('ph: analyze-provider must be "ollama" or "gemini"\n');
-        process.exit(1);
-      }
+      if (!["ollama", "gemini", "openrouter", "mlx-serve"].includes(val)) throw new Error("analyze-provider must be ollama, gemini, openrouter, or mlx-serve");
       cfg.analyzeProvider = val;
       break;
     case "ollama-url":
@@ -5237,24 +5373,36 @@ function cmdConfig(args) {
     case "ollama-model":
       cfg.ollamaModel = val;
       break;
+    case "openrouter-model":
+      cfg.openrouterModel = val;
+      break;
+    case "openrouter-url":
+      cfg.openrouterUrl = val;
+      break;
+    case "openrouter-api-key":
+      cfg.openrouterApiKey = val;
+      break;
+    case "mlx-serve-model":
+      cfg.mlxServeModel = val;
+      break;
+    case "mlx-serve-url":
+      cfg.mlxServeUrl = val;
+      break;
+    case "mlx-serve-api-key":
+      cfg.mlxServeApiKey = val;
+      break;
     case "ollama-embed-model":
       cfg.ollamaEmbedModel = val;
       break;
     case "filter-min-length": {
       const n = Number(val);
-      if (isNaN(n) || n < 0) {
-        process.stderr.write("ph: filter-min-length must be a non-negative integer\n");
-        process.exit(1);
-      }
+      if (!Number.isInteger(n) || n < 0) throw new Error("filter-min-length must be a non-negative integer");
       cfg.filterMinLength = n;
       break;
     }
     case "filter-min-relevance": {
       const n = Number(val);
-      if (isNaN(n) || n < 0 || n > 10) {
-        process.stderr.write("ph: filter-min-relevance must be 0-10\n");
-        process.exit(1);
-      }
+      if (!Number.isInteger(n) || n < 0 || n > 10) throw new Error("filter-min-relevance must be 0-10");
       cfg.filterMinRelevance = n;
       break;
     }
@@ -5268,12 +5416,43 @@ function cmdConfig(args) {
       cfg.remoteApiKey = val;
       break;
     default:
-      process.stderr.write(`ph: unknown config key "${key}"
-`);
-      process.exit(1);
+      throw new Error(`unknown config key "${key}"`);
   }
   save(cfg);
-  console.log(`Config "${key}" updated successfully.`);
+  console.log(SECRET_KEYS.includes(key) ? `Config "${key}" updated (value hidden).` : `Config "${key}" updated successfully.`);
+}
+function readSecret(prompt) {
+  if (!process.stdin.isTTY) throw new Error(`No value supplied for ${prompt.trim()}; use an environment variable in non-interactive shells.`);
+  return new Promise((resolve, reject) => {
+    const input = process.stdin;
+    const previousRawMode = input.isRaw ?? false;
+    let value = "";
+    process.stderr.write(prompt);
+    input.setRawMode(true);
+    input.resume();
+    const cleanup = () => {
+      input.removeListener("data", onData);
+      input.setRawMode(previousRawMode);
+      process.stderr.write("\n");
+    };
+    const onData = (chunk) => {
+      for (const byte of chunk) {
+        if (byte === 3) {
+          cleanup();
+          reject(new Error("Input cancelled."));
+          return;
+        }
+        if (byte === 13 || byte === 10) {
+          cleanup();
+          resolve(value);
+          return;
+        }
+        if (byte === 127 || byte === 8) value = value.slice(0, -1);
+        else if (byte >= 32) value += String.fromCharCode(byte);
+      }
+    };
+    input.on("data", onData);
+  });
 }
 
 // src/commands/background-analyze.ts
@@ -6454,6 +6633,40 @@ ${userPrompt}`;
   process.exit(child.status ?? 0);
 }
 
+// src/commands/models.ts
+async function cmdModels(cfg, args) {
+  const provider = args[0] ?? cfg.analyzeProvider;
+  if (provider !== "openrouter" && provider !== "mlx-serve") {
+    throw new Error("Choose a provider: `ph models openrouter` or `ph models mlx-serve`.");
+  }
+  const cfgKey = provider === "openrouter" ? cfg.openrouterApiKey : cfg.mlxServeApiKey;
+  if (provider === "openrouter" && !(process.env.OPENROUTER_API_KEY || cfgKey)) {
+    throw new Error("Configure a key with `ph config set openrouter-api-key` or set OPENROUTER_API_KEY.");
+  }
+  const apiKey = provider === "openrouter" ? process.env.OPENROUTER_API_KEY ?? cfg.openrouterApiKey : process.env.MLX_SERVE_API_KEY ?? process.env.GLB_OMLX_API_KEY ?? cfg.mlxServeApiKey ?? "local";
+  const baseUrl = provider === "openrouter" ? process.env.OPENROUTER_BASE_URL ?? cfg.openrouterUrl ?? OPENROUTER_DEFAULT_URL : process.env.MLX_SERVE_BASE_URL ?? cfg.mlxServeUrl ?? MLX_SERVE_DEFAULT_URL;
+  let models;
+  try {
+    models = await discoverModels(provider, apiKey, baseUrl);
+  } catch (error) {
+    const detail = error instanceof Error ? error.message : String(error);
+    const tunnel = provider === "mlx-serve" && /127\.0\.0\.1|localhost/.test(baseUrl) ? "\nParmenide: apri in un altro terminale `ssh -N -L 11234:127.0.0.1:11234 parmenide`, poi riprova. Puoi impostare un URL raggiungibile con `ph config set mlx-serve-url <url>`." : "";
+    throw new Error(`Cannot query ${provider} at ${baseUrl}: ${detail}${tunnel}`);
+  }
+  if (models.length === 0) {
+    const tunnel = provider === "mlx-serve" ? "\nSe il CLI gira sul Mac e il server su Parmenide, apri: ssh -N -L 11234:127.0.0.1:11234 parmenide" : "";
+    throw new Error(`No models returned by ${provider} at ${baseUrl}. Check connectivity and credentials.${tunnel}`);
+  }
+  console.log(`Models listed by ${provider} at ${baseUrl}:`);
+  for (const model of models) {
+    const status2 = model.loaded === void 0 ? "" : model.loaded ? " [loaded]" : ` [${model.state ?? "unloaded"}]`;
+    console.log(`  ${model.id}${model.name !== model.id ? `  \u2014 ${model.name}` : ""}${status2}`);
+  }
+  if (provider === "mlx-serve") {
+    console.log("\nph can list installed models even when they are unloaded. Select a model marked [loaded] to run it immediately.");
+  }
+}
+
 // src/cli.ts
 var USAGE = `ph \u2014 prompt history tracker
 
@@ -6473,6 +6686,7 @@ USAGE:
   ph import <source> [--dry-run] [--analyze] [--filter] [--file <path>]
                                                 Import from Gemini, Claude, OpenCode, or Codex history
   ph analyze [--limit n] [--force] [--prune] [--dry-run]  Analyze prompts with LLM
+  ph models [openrouter|mlx-serve]     List models from an AI provider
   ph mcp                                Start MCP server (Stdio)
   ph server [--port 3001]               Start HTTP REST server for remote sync
   ph timeline [project]                 Show full project history with prompts and memories
@@ -6483,7 +6697,8 @@ USAGE:
   ph cleanup-reusability [--dry-run] [--threshold 0.7] [--force]  Cleanup based on reusability
   ph embed-all                          Generate embeddings for all prompts
   ph log --tool <name> --prompt <text> [--response <text>]  Log a prompt+response directly
-  ph config set <key> <value>           Save config value
+  ph config show                        Show active AI provider configuration
+  ph config set <key> [value]           Save config value (secret keys prompt hidden)
   ph browse                             Interactive TUI browser
 
 WRAP FLAGS (placed before the tool name):
@@ -6557,6 +6772,8 @@ EXAMPLES:
   ph config set background-analysis true
   ph config set ollama-model llama3.2:latest
   ph ollama-models                          List models available on the local Ollama instance
+  ph models openrouter                      Discover OpenRouter models
+  ph models mlx-serve                       Discover models on MLX-Serve (default Parmenide tunnel)
 `;
 async function openBrowser(db, opts = {}) {
   let pendingRerun = null;
@@ -6577,8 +6794,20 @@ async function openBrowser(db, opts = {}) {
   }
   return pendingRerun;
 }
-function runRerun(rerun) {
+async function runRerun(rerun, dbPath, cfg) {
   if (!rerun) return;
+  if (rerun.tool.startsWith("wise:")) {
+    const providerId = rerun.tool.slice("wise:".length);
+    const setupError = getProviderSetupError(cfg, providerId);
+    if (setupError) throw new Error(setupError);
+    const provider = getProvider(cfg, providerId);
+    if (!provider) throw new Error(`Cannot create ${providerId} provider from the saved configuration.`);
+    const response = await provider.generate(rerun.prompt);
+    process.stdout.write(`${response}
+`);
+    await cmdLog(dbPath, cfg, ["--tool", `wise:${providerId}`, "--prompt", rerun.prompt, "--response", response]);
+    return;
+  }
   const realBin = resolveRealBinary(rerun.tool);
   const child = spawnSync2(realBin, [rerun.prompt], { stdio: "inherit" });
   process.exit(child.status ?? 0);
@@ -6595,7 +6824,7 @@ async function main() {
       const db = new PhDB(dbPath);
       const rerun = await openBrowser(db);
       db.close();
-      runRerun(rerun);
+      await runRerun(rerun, dbPath, cfg);
       process.exit(0);
     } else {
       process.stdout.write(USAGE);
@@ -6638,7 +6867,7 @@ async function main() {
           }
         });
         db2.close();
-        runRerun(rerun);
+        await runRerun(rerun, dbPath, cfg);
         break;
       }
       const db = new PhDB(dbPath);
@@ -6712,6 +6941,10 @@ async function main() {
       db.close();
       break;
     }
+    case "models": {
+      await cmdModels(cfg, cmdArgs);
+      break;
+    }
     case "memory-migrate": {
       const db = new PhDB(dbPath);
       cmdMemoryMigrate(db);
@@ -6756,7 +6989,7 @@ async function main() {
       break;
     }
     case "config":
-      cmdConfig(cmdArgs);
+      await cmdConfig(cmdArgs);
       break;
     case "_bg-analyze": {
       await cmdBackgroundAnalyze(dbPath, cmdArgs);
@@ -6766,7 +6999,7 @@ async function main() {
       const db = new PhDB(dbPath);
       const rerun = await openBrowser(db);
       db.close();
-      runRerun(rerun);
+      await runRerun(rerun, dbPath, cfg);
       break;
     }
     case "chat": {