@gi4nks/ph 1.6.0 → 1.7.0

package/docs/ph-manual.md

@@ -10,6 +10,8 @@ ph is a transparent observability and knowledge layer for AI CLI tools (Claude C
 
 **Core principle:** ph captures conversations without changing the normal tool workflow. Optional analysis turns captured history into project summaries and memories that can be searched locally or requested by an MCP client. Capture and full-text search work without an LLM provider; analysis, embeddings, and semantic search require the configured provider.
 
+In the TUI, `p` runs the selected prompt through one of the configured Wise analysis providers (same provider/model/URL settings shown by `ph config show`) and saves the response to history. `r` reruns the prompt with its original CLI tool.
+
 ### Key Features
 
 - **Automatic capture** via hooks (Claude Code, Codex CLI, Gemini CLI, OpenCode plugin) or wrapper mode
@@ -45,7 +47,7 @@ npm link
 
 ```bash
 ph config set background-analysis true   # auto-analyze after each capture
-ph config set analyze-provider ollama     # ollama (default) or gemini
+ph config set analyze-provider ollama     # ollama (default), gemini, openrouter, or mlx-serve
 ph config set ollama-model llama3.1:latest
 ```
 
@@ -283,6 +285,37 @@ ph config set ollama-model llama3.1:latest
 ph config set ollama-embed-model nomic-embed-text-v2-moe
 ```
 
+OpenRouter and MLX-Serve generation use `@gi4nks/wise`:
+
+```bash
+# OpenRouter: credentials stay in the environment; model IDs keep provider/model.
+export OPENROUTER_API_KEY="your_openrouter_api_key"
+ph models openrouter
+ph config set openrouter-api-key  # hidden prompt; or keep using the environment
+ph config set analyze-provider openrouter
+ph config set openrouter-model "provider/model-id"
+ph config show                    # provider settings with credentials redacted
+ph analyze
+
+# MLX-Serve on Parmenide: open this tunnel in a separate terminal.
+ssh -N -L 11234:127.0.0.1:11234 parmenide
+```
+
+```bash
+# In the terminal where you run ph:
+ph models mlx-serve
+ph config set analyze-provider mlx-serve
+ph config set mlx-serve-model "exact-model-id-from-server"
+ph analyze
+```
+
+MLX-Serve defaults to `http://127.0.0.1:11234/v1`. Override it with
+`MLX_SERVE_BASE_URL` or `ph config set mlx-serve-url <url>`. Set
+`MLX_SERVE_API_KEY` if the server requires auth; `GLB_OMLX_API_KEY` is also
+accepted for existing setups. Alternatively run `ph config set mlx-serve-api-key`
+to enter it without echoing it in the terminal. `ph config show` redacts
+credentials. `ph models mlx-serve` marks entries `[loaded]` or `[unloaded]`.
+
 ---
 
 ## 9. MCP Server
@@ -380,11 +413,15 @@ ph config set filter-min-relevance 3
 | Key | Default | Description |
 |-----|---------|-------------|
 | `dbPath` | `~/.prompt_history.db` | SQLite database path |
-| `analyzeProvider` | `ollama` | LLM provider: `ollama` or `gemini` |
+| `analyzeProvider` | `ollama` | LLM provider: `ollama`, `gemini`, `openrouter`, or `mlx-serve` |
 | `ollamaUrl` | `http://localhost:11434` | Ollama server URL |
 | `ollamaModel` | `llama3.1:latest` | Analysis model |
 | `ollamaEmbedModel` | `nomic-embed-text-v2-moe` | Embedding model |
 | `geminiApiKey` | — | Gemini API key |
+| `openrouterModel` | — | Exact OpenRouter model ID |
+| `openrouterUrl` | `https://openrouter.ai/api/v1` | OpenRouter-compatible API root |
+| `mlxServeModel` | — | Exact MLX-Serve model ID |
+| `mlxServeUrl` | `http://127.0.0.1:11234/v1` | MLX-Serve API root (Parmenide SSH tunnel by default) |
 | `backgroundAnalysis` | `false` | Auto-analyze after each capture |
 | `filterMinLength` | `15` | Min prompt length to keep |
 | `filterMinRelevance` | `3` | Min relevance to keep (0=disable) |
@@ -397,6 +434,10 @@ ph config set filter-min-relevance 3
 | `remoteLastPush` | — | Timestamp of last successful push |
 | `remoteLastPull` | — | Timestamp of last successful pull |
 
+Provider API credentials are environment-only: `OPENROUTER_API_KEY` and
+`MLX_SERVE_API_KEY` (`GLB_OMLX_API_KEY` is a fallback). They are not written to
+`~/.ph_config.json`.
+
 ---
 
 ## 14. Architecture

package/hooks/claude/README.md

@@ -25,7 +25,7 @@ Add (or update) the `hooks` section in your `~/.claude/settings.json` file:
         "hooks": [
           {
             "type": "command",
-            "command": "/Users/gianluca/.claude/ph-hook.sh",
+            "command": "$HOME/.claude/ph-hook.sh",
             "async": true
           }
         ]

package/hooks/gemini/README.md

@@ -24,7 +24,7 @@ Add (or update) the `hooks` section in your `~/.gemini/settings.json` file:
         "hooks": [
           {
             "type": "command",
-            "command": "/Users/gianluca/.gemini/ph-hook.sh"
+            "command": "$HOME/.gemini/ph-hook.sh"
           }
         ]
       }

package/package.json

@@ -1,9 +1,12 @@
 {
   "name": "@gi4nks/ph",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Transparent CLI wrapper that captures and indexes AI prompts",
   "type": "module",
   "license": "MIT",
+  "engines": {
+    "node": ">=22"
+  },
   "bin": {
     "ph": "dist/cli.js"
   },
@@ -56,8 +59,10 @@
   },
   "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",