pterm 0.0.15 → 0.0.16

package/README.md

@@ -108,9 +108,11 @@ Run a launcher. Equivalent to the user visiting a launcher page. Will run whiche
 ### syntax
 
 ```
-pterm run <launcher_path>
+pterm run <launcher_path_or_uri> [--open]
 ```
 
+- `--open`: (optional) open URL results in the browser. Default behavior is to print the URL to stdout without opening a browser.
+
 ### examples
 
 Launch the launcher in the current path
@@ -125,6 +127,88 @@ Launch from absolute path
 pterm run /pinokio/api/test
 ```
 
+Run from a launcher URI and auto-open the resulting URL in browser
+
+```
+pterm run https://github.com/example/my-launcher --open
+```
+
+## search
+
+Search installed or available apps.
+
+### syntax
+
+```
+pterm search [query words...]
+pterm search --q="<query>"
+pterm search "<query>" [--mode=balanced|broad|strict] [--min-match=<n>] [--limit=<n>]
+```
+
+- `--mode`: (optional) search strategy. `broad` (default), `balanced`, or `strict`.
+- `--min-match`: (optional) minimum number of query terms an app should match.
+- `--limit`: (optional) max number of app results to return.
+
+### examples
+
+```
+pterm search comfyui
+```
+
+```
+pterm search --q="text generation"
+```
+
+```
+pterm search "tts speech synthesis" --mode=balanced --min-match=2 --limit=8
+```
+
+## status
+
+Get app status by app id.
+
+### syntax
+
+```
+pterm status <app_id> [--probe] [--timeout=<ms>]
+```
+
+- `--probe`: (optional) actively probe app health.
+- `--timeout`: (optional) probe timeout in milliseconds.
+
+### examples
+
+```
+pterm status comfyanonymous-comfyui
+```
+
+```
+pterm status comfyanonymous-comfyui --probe --timeout=5000
+```
+
+## logs
+
+Get app logs by app id.
+
+### syntax
+
+```
+pterm logs <app_id> [--script=<name>] [--tail=<lines>]
+```
+
+- `--script`: (optional) filter to a script.
+- `--tail`: (optional) return only the last N lines.
+
+### examples
+
+```
+pterm logs comfyanonymous-comfyui
+```
+
+```
+pterm logs comfyanonymous-comfyui --script=start --tail=200
+```
+
 ## filepicker
 
 Display a file picker dialog, which lets the user select one or more file or folder paths, powered by tkinter.
@@ -268,4 +352,3 @@ pterm push 'this is a notification' --sound
 ```
 pterm push 'this is an image notification' --image=icon.png
 ```
-

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pterm",
-  "version": "0.0.15",
+  "version": "0.0.16",
   "description": "",
   "main": "index.js",
   "bin": {

package/util.js

@@ -9,8 +9,27 @@ class Util {
   }
   async search(argv) {
     const query = (argv._.slice(1).join(" ") || argv.q || "").trim()
+    const params = { q: query }
+    const mode = typeof argv.mode === "string" ? argv.mode.trim().toLowerCase() : ""
+    const minMatchRaw = argv.minMatch ?? argv["min-match"] ?? argv.min_match
+    const limitRaw = argv.limit
+    if (mode === "broad" || mode === "balanced" || mode === "strict") {
+      params.mode = mode
+    }
+    if (minMatchRaw !== undefined && minMatchRaw !== null && minMatchRaw !== "") {
+      const minMatch = Number.parseInt(String(minMatchRaw), 10)
+      if (Number.isFinite(minMatch) && minMatch > 0) {
+        params.min_match = String(minMatch)
+      }
+    }
+    if (limitRaw !== undefined && limitRaw !== null && limitRaw !== "") {
+      const limit = Number.parseInt(String(limitRaw), 10)
+      if (Number.isFinite(limit) && limit > 0) {
+        params.limit = String(limit)
+      }
+    }
     const response = await axios.get("http://localhost:42000/apps/search", {
-      params: { q: query }
+      params
     })
     this.printJson(response.data)
   }