@rupayan10/aios-cli 0.1.2 → 0.1.4

package/dist/cli.js

@@ -3518,7 +3518,7 @@ var init_package = __esm({
   "package.json"() {
     package_default = {
       name: "@rupayan10/aios-cli",
-      version: "0.1.2",
+      version: "0.1.4",
       description: "FlowScale AIOS command-line interface",
       license: "AGPL-3.0-only",
       bin: {
@@ -5541,6 +5541,10 @@ var init_render = __esm({
 // src/commands/gpu.ts
 function registerGpu(program2) {
   const gpu = program2.command("gpu").description("GPU management");
+  gpu.addHelpText("after", `
+Examples:
+  $ aios gpu list
+  $ aios gpu detect --json       force re-detection (clears the cache)`);
   function printGpus(gpus, json) {
     if (json) {
       process.stdout.write(renderJson(gpus) + "\n");
@@ -5793,7 +5797,7 @@ function upsertModels(comfyPort, models) {
   writeTxn((db2) => {
     db2.prepare("DELETE FROM models WHERE comfy_port = ?").run(comfyPort);
     const ins = db2.prepare(`INSERT INTO models (id, filename, path, type, size_bytes, comfy_port, scanned_at) VALUES (?, ?, ?, ?, ?, ?, ?)
-      ON CONFLICT(id) DO UPDATE SET filename = excluded.filename, scanned_at = excluded.scanned_at`);
+      ON CONFLICT(path) DO UPDATE SET filename = excluded.filename, type = excluded.type, size_bytes = excluded.size_bytes, comfy_port = excluded.comfy_port, scanned_at = excluded.scanned_at`);
     for (const m of models) ins.run(m.id, m.filename, m.path, m.type, m.sizeBytes, m.comfyPort, m.scannedAt);
   });
 }
@@ -10123,6 +10127,16 @@ function collectInput(val, acc) {
 }
 function registerTools(program2) {
   const tools = program2.command("tools").description("Tool management");
+  tools.addHelpText("after", `
+Examples:
+  $ aios tools build flux.json --name "Flux Dev" --instance auto
+  $ aios tools build wf.json --inputs 6__text --outputs 9__images    keep only a subset
+  $ aios tools list --json
+  $ aios tools run <id> --input 6__text="a cat" --input 4__image=@cat.png --instance auto
+  $ aios tools show <executionId>
+
+ComfyUI inputs are keyed <nodeId>__<paramName> (e.g. 6__text); plugin inputs use api__<paramName>.
+Prefix a value with @ to upload a local file (e.g. --input 4__image=@photo.png).`);
   const build = tools.command("build").description("Create a tool from a ComfyUI workflow JSON file").argument("<workflow.json>", "path to a ComfyUI workflow JSON file").option("--name <name>", "tool name (defaults to the filename)").option("--instance <id>", "a running instance to resolve widget names via /object_info").option("--inputs <keys>", "comma-separated nodeId__param input keys to keep (default: all)").option("--outputs <keys>", "comma-separated output keys to keep (default: all)").option("--json", "machine-readable JSON output");
   build.action(async (file) => {
     const o2 = build.opts();
@@ -10669,6 +10683,13 @@ var init_comfy_logs = __esm({
 // src/commands/comfy.ts
 function registerComfy(program2) {
   const comfy = program2.command("comfy").description("ComfyUI instance management");
+  comfy.addHelpText("after", `
+Examples:
+  $ aios comfy detect            generate instance configs from detected GPUs
+  $ aios comfy status            which instances are alive
+  $ aios comfy start gpu-0       start one instance (omit id to start all)
+  $ aios comfy logs gpu-0 -n 100
+  $ aios comfy stop gpu-0`);
   const status = comfy.command("status").description("Show ComfyUI instance status").option("--json", "machine-readable JSON output");
   status.action(() => {
     const json = Boolean(status.opts().json);
@@ -10803,6 +10824,10 @@ var init_model_scanner = __esm({
 // src/commands/models.ts
 function registerModels(program2) {
   const models = program2.command("models").description("Local model management");
+  models.addHelpText("after", `
+Examples:
+  $ aios models scan --instance auto             HTTP-scan a running instance
+  $ aios models list --type checkpoint --json`);
   const scan = models.command("scan").description("Scan a running ComfyUI instance for models").requiredOption("--instance <id>", 'instance id or "auto"').option("--json", "machine-readable JSON output");
   scan.action(async () => {
     const o2 = scan.opts();
@@ -10851,6 +10876,12 @@ var init_models = __esm({
 // src/commands/plugins.ts
 function registerPlugins(program2) {
   const plugins = program2.command("plugins").description("API-engine tool plugin management");
+  plugins.addHelpText("after", `
+Examples:
+  $ aios plugins install flux1-lora-trainer       from the FlowScale registry
+  $ aios plugins import ./my-plugin               local dir or a GitHub URL
+  $ aios plugins start flux1-lora-trainer
+  $ aios tools run flux1-lora-trainer-builtin --input api__prompt="a cat" --start`);
   const list = plugins.command("list").description("List locally installed tool plugins").option("--json", "machine-readable JSON output");
   list.action(() => {
     const o2 = list.opts();
@@ -11033,6 +11064,11 @@ var init_open_file = __esm({
 // src/commands/assets.ts
 function registerAssets(program2) {
   const assets = program2.command("assets").description("Saved execution outputs (assets)");
+  assets.addHelpText("after", `
+Examples:
+  $ aios assets list --tool <id> --json
+  $ aios assets show <executionId>
+  $ aios assets open <executionId>               open the first output in your viewer`);
   const list = assets.command("list").description("List completed execution outputs resolved to disk").option("--tool <id>", "filter by tool id").option("--json", "machine-readable JSON output");
   list.action(() => {
     const o2 = list.opts();
@@ -12254,6 +12290,16 @@ function buildProgram() {
   registerModels(program2);
   registerPlugins(program2);
   registerAssets(program2);
+  program2.addHelpText("after", `
+Examples:
+  $ aios                                              interactive menu (in a TTY)
+  $ aios gpu list                                     show detected GPUs
+  $ aios comfy detect && aios comfy start gpu-0       configure + launch an instance
+  $ aios tools build workflow.json --instance auto    build a tool from a workflow
+  $ aios tools run <toolId> --input 6__text="a cat" --instance auto
+  $ aios assets open <executionId>                    open the rendered output
+
+Add --json to most commands for scripting. Run \`aios help <command>\` for per-command examples.`);
   return program2;
 }
 async function main(argv) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rupayan10/aios-cli",
-  "version": "0.1.2",
+  "version": "0.1.4",
   "description": "FlowScale AIOS command-line interface",
   "license": "AGPL-3.0-only",
   "bin": {