pterm 0.0.22 → 0.0.24

package/README.md

@@ -149,6 +149,42 @@ Launch a script directly with query parameters. Query parameters are passed thro
 pterm start 'run.js?mode=Default'
 ```
 
+## download
+
+Clone an app repo into Pinokio's app directory without launching it.
+
+### syntax
+
+```
+pterm download <uri> [name] [--branch=<branch>]
+pterm download <uri> [name] -b <branch>
+```
+
+- `uri`: required git repository URI
+- `name`: (optional) target folder name under `PINOKIO_HOME/api`
+- `--branch` / `-b`: (optional) clone a specific branch
+
+Behavior:
+
+- if `name` is omitted, Pinokio uses the same default destination folder naming as `git clone <uri>`
+- if `name` is provided, Pinokio clones into `PINOKIO_HOME/api/<name>`
+- if the target folder already exists, the command fails with `already exists`
+- the command does not dedupe by repo URL
+
+### examples
+
+```
+pterm download https://github.com/example/my-launcher.git
+```
+
+```
+pterm download https://github.com/example/my-launcher.git my-launcher-dev
+```
+
+```
+pterm download https://github.com/example/my-launcher.git my-launcher-dev --branch=feature-x
+```
+
 ## search
 
 Search installed or available apps.
@@ -179,6 +215,41 @@ pterm search --q="text generation"
 pterm search "tts speech synthesis" --mode=balanced --min-match=2 --limit=8
 ```
 
+## registry search
+
+Search the remote Pinokio registry.
+
+### syntax
+
+```
+pterm registry search [query words...]
+pterm registry search --q="<query>" [--limit=<n>] [--sort=relevance|popular|trending|latest|created|checkins|name] [--platform=mac|windows|linux] [--gpu=nvidia|amd|apple]
+```
+
+- `--limit`: (optional) max number of app results to return.
+- `--sort`: (optional) result ordering. Default is `relevance`.
+- `--platform`: (optional) filter by observed platform support from public check-ins.
+- `--gpu`: (optional) filter by observed GPU support from public check-ins.
+
+By default, this command queries `https://api.pinokio.co/v1/search`. Override with `PINOKIO_REGISTRY_API_BASE`.
+
+### examples
+
+```
+pterm registry search tts
+```
+
+```
+pterm registry search "speech synthesis" --limit=5
+```
+
+PINOKIO_REGISTRY_API_BASE=https://api.pinokio.co pterm registry search comfyui --platform=mac --gpu=apple
+```
+
+```
+PINOKIO_REGISTRY_API_BASE=https://api.pinokio.co pterm registry search comfyui --sort=popular
+```
+
 ## which
 
 Resolve the executable path for a command name through Pinokio's environment.

package/index.js

@@ -58,7 +58,14 @@ const isHttpUri = (value) => typeof value === "string" && /^https?:\/\//i.test(v
     } else if (cmd === "filepicker") {
       await util.filepicker(argv)
     } else if (cmd === "download") {
-      await util.download(argv)
+      await util.appDownload(argv)
+    } else if (cmd === "registry") {
+      const subcmd = argv._.length > 1 ? String(argv._[1]).toLowerCase() : ""
+      if (subcmd === "search") {
+        await util.registrySearch(argv)
+      } else {
+        console.error("supported subcommands: search")
+      }
     } else if (cmd === "search") {
       await util.search(argv)
     } else if (cmd === "stars") {

package/package.json

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

package/util.js

@@ -7,6 +7,17 @@ class Util {
     process.stdout.write(JSON.stringify(payload, null, 2))
     process.stdout.write("\n")
   }
+  formatRpcError(payload) {
+    if (typeof payload !== "string") {
+      return JSON.stringify(payload)
+    }
+    const [firstLine] = payload.split(/\r?\n/)
+    return firstLine || payload
+  }
+  registryBase() {
+    const value = String(process.env.PINOKIO_REGISTRY_API_BASE || "https://api.pinokio.co").trim()
+    return value.replace(/\/$/, "")
+  }
   async search(argv) {
     const query = (argv._.slice(1).join(" ") || argv.q || "").trim()
     const params = { q: query }
@@ -33,6 +44,35 @@ class Util {
     })
     this.printJson(response.data)
   }
+  async registrySearch(argv) {
+    const query = (argv._.slice(2).join(" ") || argv.q || "").trim()
+    if (!query) {
+      console.error("required argument: <query>")
+      return
+    }
+    const params = { q: query }
+    const limitRaw = argv.limit
+    const sortRaw = typeof argv.sort === "string" ? argv.sort.trim().toLowerCase() : ""
+    const platformRaw = typeof argv.platform === "string" ? argv.platform.trim().toLowerCase() : ""
+    const gpuRaw = typeof argv.gpu === "string" ? argv.gpu.trim().toLowerCase() : ""
+    if (limitRaw !== undefined && limitRaw !== null && limitRaw !== "") {
+      const limit = Number.parseInt(String(limitRaw), 10)
+      if (Number.isFinite(limit) && limit > 0) {
+        params.limit = String(limit)
+      }
+    }
+    if (["relevance", "popular", "trending", "latest", "created", "checkins", "name"].includes(sortRaw)) {
+      params.sort = sortRaw
+    }
+    if (platformRaw === "mac" || platformRaw === "windows" || platformRaw === "linux") {
+      params.platform = platformRaw
+    }
+    if (gpuRaw === "nvidia" || gpuRaw === "amd" || gpuRaw === "apple") {
+      params.gpu = gpuRaw
+    }
+    const response = await axios.get(`${this.registryBase()}/v1/search`, { params })
+    this.printJson(response.data)
+  }
   async status(argv) {
     if (argv._.length <= 1) {
       console.error("required argument: <app_id>")
@@ -216,6 +256,51 @@ class Util {
     let response = await axios.post("http://localhost:42000/go", { url })
     return response
   }
+  async appDownload(argv) {
+    if (argv._.length <= 1) {
+      console.error("required argument: <uri>")
+      process.exitCode = 1
+      return
+    }
+    const uri = String(argv._[1]).trim()
+    const name = argv._.length > 2 ? String(argv._[2]).trim() : ""
+    const branch = typeof argv.b === "string"
+      ? argv.b.trim()
+      : (typeof argv.branch === "string" ? argv.branch.trim() : "")
+    const rpc = new RPC("ws://localhost:42000")
+    let exitCode = 0
+    await rpc.run({
+      method: "app.download",
+      params: {
+        uri,
+        ...(name ? { name } : {}),
+        ...(branch ? { branch } : {})
+      }
+    }, (packet) => {
+      if (packet.type === "result") {
+        if (!packet.data || packet.data.ok === false) {
+          exitCode = 1
+          const message = packet.data && packet.data.error ? packet.data.error : "download failed"
+          if (packet.data && packet.data.path) {
+            console.error(`${message}: ${packet.data.path}`)
+          } else {
+            console.error(message)
+          }
+        }
+        rpc.close()
+      } else if (packet.type === "stream") {
+        process.stdout.write(packet.data.raw)
+      } else if (packet.type === "error") {
+        exitCode = 1
+        console.error(this.formatRpcError(packet.data))
+        rpc.close()
+      }
+    })
+    if (exitCode !== 0) {
+      process.exitCode = exitCode
+    }
+  }
+  // Keep the legacy URL download flow for `pterm run <url>`.
   async download(argv) {
     if (argv._.length > 1) {
       let uri = argv._[1]