ollanet 0.6.1 → 0.6.2

package/README.md

@@ -198,6 +198,7 @@ optimizeDeps: { exclude: ["ollanet"] },
 | `ollanet chats` | List or inspect saved transcripts |
 | `ollanet bench …` | Benchmark models for tok/s + lightweight quality checks |
 | `ollanet mcp` | Stdio [MCP](https://modelcontextprotocol.io) server for agents |
+| `ollanet help [command]` | This overview, or one command’s flags (`ollanet help bench`, `ollanet bench help`) |
 
 ### `scan` options
 

package/dist/argv.d.ts

@@ -3,6 +3,11 @@
  */
 import type { GenerateSettings } from "./config.js";
 export type UsageFn = () => never;
+export declare function isHelpFlag(arg: string): boolean;
+/** Intentional help: stdout, exit 0. */
+export declare function printHelp(text: string): never;
+/** Usage error: stderr, exit 1. */
+export declare function failUsage(text: string): never;
 export declare function takeValue(args: string[], flag: string, usage: UsageFn): string;
 /** `--name value` or `--name=value`. Returns undefined if `arg` is not this flag. */
 export declare function takeFlag(arg: string, name: string, args: string[], usage: UsageFn): string | undefined;

package/dist/argv.js

@@ -1,3 +1,16 @@
+export function isHelpFlag(arg) {
+    return arg === "--help" || arg === "-h";
+}
+/** Intentional help: stdout, exit 0. */
+export function printHelp(text) {
+    process.stdout.write(text.endsWith("\n") ? text : `${text}\n`);
+    process.exit(0);
+}
+/** Usage error: stderr, exit 1. */
+export function failUsage(text) {
+    console.error(text);
+    process.exit(1);
+}
 export function takeValue(args, flag, usage) {
     const value = args.shift();
     if (!value) {

package/dist/bench.d.ts

@@ -1 +1,2 @@
+export declare function helpText(): string;
 export declare function main(): Promise<void>;

package/dist/bench.js

@@ -6,42 +6,50 @@ import { comparabilityKey, getSuiteCases, median, suiteRevision, } from "./bench
 import { benchmarksDir, newBenchId, saveBenchmark } from "./bench-store.js";
 import { readFile } from "node:fs/promises";
 import { envInt, ollamaBaseUrl, shortName } from "./hosts.js";
-import { consumeSettingsFlag, parseNumberFlag, takeFlag } from "./argv.js";
+import { consumeSettingsFlag, failUsage, isHelpFlag, parseNumberFlag, printHelp, takeFlag } from "./argv.js";
 import { resolveTarget } from "./target.js";
 import { projectPath } from "./paths.js";
 import { contextLengthForModel, isCompletionCapable, isVisionCapable, ollamaChat, ollamaShow, ollamaTags, ollamaUnload, ollamaVersion, ollamaPs, psHasModel, shouldWarnNoThinking, vramForModel, waitUntilUnloaded, } from "./ollama-chat.js";
 const MODEL_COL = 34;
 const BENCH_TIMEOUT_MS = envInt("OLLAMA_BENCH_TIMEOUT_MS", 60_000);
 const UNLOAD_WAIT_MS = envInt("OLLAMA_BENCH_UNLOAD_WAIT_MS", 60_000);
-function usage() {
-    console.error(`Usage:
+export function helpText() {
+    return `Usage:
   ollanet bench <machine|ip> [model...] [options]
   ollanet bench <machine|ip> --all [options]
 
 Examples:
   ollanet bench studio gemma3:12b --runs 5
   ollanet bench studio gemma3:12b --hot --runs 5
+  ollanet help bench
+
+Fixed suite (not compare). Checks run once; throughput repeats --runs times.
+Median tok/s excludes early-stops. Unload is between models, not between repeats.
 
 Options:
   --all                 Every completion-capable model from /api/tags
   --exclude-vision      With --all, skip models that advertise vision
   --suite quick|full    Prompt suite (default quick)
-  --runs <n>            Throughput repeats (default 3)
+  --runs <n>            Counted throughput repeats (default 3)
   --hot                 Discard first throughput run; keep models loaded
-  --warmup / --no-warmup
+  --warmup              Short discarded call before timed cases (default on)
+  --no-warmup           Skip the short warmup (--hot implies this)
   --cold-load           Measure cold load via unload + /api/ps
   --num-predict <n>     Pin throughput length (default 256)
-  --num-ctx <n>
-  --keep-alive <value>
-  --think / --no-think
-  --judge --judge-model <name>
+  --num-ctx <n>         Context window override
+  --keep-alive <value>  Keep model loaded (e.g. 5m, 0, -1)
+  --think / --no-think  Thinking tokens (default off)
+  --judge               Second pass: score check answers 1–5
+  --judge-model <name>  Required with --judge (no default)
   --json                Machine-readable stdout
-  --save / --no-save
-  --fail-fast
+  --save / --no-save    Persist under benchmarks/ (default on)
+  --fail-fast           Stop remaining models after the first hard error
   --fail-on-error       Exit 2 if any model/case errored
 
-See docs/bench-spec.md for measurement rules.`);
-    process.exit(1);
+See docs/bench-spec.md for measurement rules.`;
+}
+function usage() {
+    failUsage(helpText());
 }
 function isLoopback(host) {
     return (host.source === "localhost" ||
@@ -90,7 +98,9 @@ function parseArgs(argv) {
     const positional = [];
     while (args.length > 0) {
         const arg = args.shift();
-        if (arg === "--" || arg === "--help" || arg === "-h")
+        if (isHelpFlag(arg))
+            printHelp(helpText());
+        if (arg === "--")
             usage();
         if (arg === "--all") {
             all = true;

package/dist/chats.d.ts

@@ -6,4 +6,5 @@
  *   ollanet chats --json
  *   ollanet chats --id a1b2c3d4e5f6
  */
+export declare function helpText(): string;
 export declare function main(): Promise<void>;

package/dist/chats.js

@@ -7,16 +7,18 @@
  *   ollanet chats --id a1b2c3d4e5f6
  */
 import { loadChat, listChats, responsesDir, } from "./chat-store.js";
-import { takeFlag } from "./argv.js";
-function usage() {
-    console.error(`Usage: ollanet chats [--json] [--id <hash>]
+import { failUsage, isHelpFlag, printHelp, takeFlag } from "./argv.js";
+export function helpText() {
+    return `Usage: ollanet chats [--json] [--id <hash>]
 
 Lists transcripts in ${responsesDir()}.
 
 Options:
   --json       Machine-readable output
-  --id <hash>  Show one chat (messages included with --json, preview otherwise)`);
-    process.exit(1);
+  --id <hash>  Show one chat (messages included with --json, preview otherwise)`;
+}
+function usage() {
+    failUsage(helpText());
 }
 function parseArgs(argv) {
     const args = [...argv];
@@ -26,8 +28,8 @@ function parseArgs(argv) {
         const arg = args.shift();
         if (arg === "--")
             continue;
-        if (arg === "--help" || arg === "-h")
-            usage();
+        if (isHelpFlag(arg))
+            printHelp(helpText());
         if (arg === "--json") {
             json = true;
             continue;

package/dist/cli.js

@@ -28,6 +28,7 @@ Usage:
   ollanet chats [--json] [--id <hash>]
   ollanet bench <machine|ip> [model...] [--all] [options]
   ollanet mcp
+  ollanet help [command]
 
 Examples:
   ollanet scan
@@ -46,6 +47,7 @@ Examples:
   ollanet bench localhost --all
   ollanet bench localhost llama3.2:1b --runs 3
   ollanet bench localhost gemma3:12b --hot --runs 5
+  ollanet help bench           # flags for one command (also: ollanet bench help)
   ollanet mcp                  # stdio MCP server for agents
 
 Config: ~/.ollanet/config.json when installed, ./config.json in a checkout
@@ -58,10 +60,36 @@ async function main() {
     // pnpm/npm often forward a bare `--`; ignore it.
     const argv = process.argv.slice(2).filter((arg) => arg !== "--");
     const cmd = argv[0];
-    if (!cmd || cmd === "-h" || cmd === "--help" || cmd === "help") {
+    if (!cmd || cmd === "-h" || cmd === "--help") {
         process.stdout.write(HELP);
         return;
     }
+    if (cmd === "help") {
+        const topic = argv[1];
+        if (!topic || topic === "-h" || topic === "--help") {
+            process.stdout.write(HELP);
+            return;
+        }
+        const { commandHelp, commandNames } = await import("./help.js");
+        const text = await commandHelp(topic);
+        if (!text) {
+            console.error(`Unknown command: ${topic}`);
+            console.error(`Try: ollanet help   (commands: ${commandNames().join(", ")})`);
+            process.exitCode = 1;
+            return;
+        }
+        process.stdout.write(text.endsWith("\n") ? text : `${text}\n`);
+        return;
+    }
+    const rest = argv.slice(1);
+    const { isHelpRequest, commandHelp } = await import("./help.js");
+    if (isHelpRequest(rest)) {
+        const text = await commandHelp(cmd);
+        if (text) {
+            process.stdout.write(text.endsWith("\n") ? text : `${text}\n`);
+            return;
+        }
+    }
     if (cmd === "-v" || cmd === "--version" || cmd === "version") {
         const { readFile } = await import("node:fs/promises");
         const { projectPath } = await import("./paths.js");

package/dist/compare.d.ts

@@ -7,6 +7,7 @@
 import { type AppConfig, type GenerateSettings } from "./config.js";
 /** Used when --prompt, --file, and stdin are all omitted. */
 export declare const DEFAULT_COMPARE_PROMPT: string;
+export declare function helpText(): string;
 export interface CompareModelResult {
     model: string;
     content?: string;

package/dist/compare.js

@@ -6,7 +6,7 @@
  */
 import { configFromPartial, loadConfig, machineSettingsForHost, mergeSettings, settingsFromEnv, } from "./config.js";
 import { envInt, ollamaBaseUrl, shortName } from "./hosts.js";
-import { consumeSettingsFlag, takeFlag, takeValue } from "./argv.js";
+import { consumeSettingsFlag, failUsage, isHelpFlag, printHelp, takeFlag, takeValue } from "./argv.js";
 import { resolveTarget } from "./target.js";
 import { ollamaChat, ollamaTags, ollamaUnload, waitUntilUnloaded, } from "./ollama-chat.js";
 import { assemblePrompt, readPromptFile } from "./prompt-input.js";
@@ -23,8 +23,8 @@ function compareTimeoutMs() {
 function unloadWaitMs() {
     return envInt("OLLAMA_COMPARE_UNLOAD_WAIT_MS", 60_000);
 }
-function usage() {
-    console.error(`Usage:
+export function helpText() {
+    return `Usage:
   ollanet compare <machine> <model> <model> [model...]
   ollanet compare <machine> <model> <model> [model...] --prompt <text>
   ollanet compare <machine> <model> <model> [model...] --file <path.txt|.md>
@@ -49,8 +49,10 @@ Options:
   --think / --no-think
   --unload               Unload each model before the next (fairer tok/s)
   --no-save              Do not write compares/*
-  --json                 Emit the full record on stdout`);
-    process.exit(1);
+  --json                 Emit the full record on stdout`;
+}
+function usage() {
+    failUsage(helpText());
 }
 function parseArgs(argv) {
     const args = [...argv];
@@ -65,8 +67,8 @@ function parseArgs(argv) {
         const arg = args.shift();
         if (arg === "--")
             continue;
-        if (arg === "--help" || arg === "-h")
-            usage();
+        if (isHelpFlag(arg))
+            printHelp(helpText());
         if (arg === "--json") {
             json = true;
             continue;

package/dist/help.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Per-command help: `ollanet help bench` and `ollanet bench help`.
+ */
+export declare function canonicalCommand(name: string): string | undefined;
+export declare function commandNames(): string[];
+export declare function commandHelp(name: string): Promise<string | undefined>;
+export declare function isHelpRequest(args: string[]): boolean;

package/dist/help.js

@@ -0,0 +1,51 @@
+/**
+ * Per-command help: `ollanet help bench` and `ollanet bench help`.
+ */
+const LOADERS = {
+    scan: () => import("./scan.js"),
+    prompt: () => import("./prompt.js"),
+    chats: () => import("./chats.js"),
+    pull: () => import("./pull.js"),
+    show: () => import("./show.js"),
+    rm: () => import("./rm.js"),
+    ps: () => import("./ps.js"),
+    compare: () => import("./compare.js"),
+    bench: () => import("./bench.js"),
+    mcp: () => import("./mcp.js"),
+};
+const ALIASES = {
+    "ls-servers": "scan",
+    ask: "prompt",
+    chat: "prompt",
+    ls: "chats",
+    history: "chats",
+    download: "pull",
+    inspect: "show",
+    delete: "rm",
+    loaded: "ps",
+    vs: "compare",
+    h2h: "compare",
+    benchmark: "bench",
+};
+export function canonicalCommand(name) {
+    const key = name.trim().toLowerCase();
+    if (LOADERS[key])
+        return key;
+    return ALIASES[key];
+}
+export function commandNames() {
+    return Object.keys(LOADERS);
+}
+export async function commandHelp(name) {
+    const canon = canonicalCommand(name);
+    if (!canon)
+        return undefined;
+    const load = LOADERS[canon];
+    if (!load)
+        return undefined;
+    const mod = await load();
+    return mod.helpText();
+}
+export function isHelpRequest(args) {
+    return args.length === 1 && (args[0] === "help" || args[0] === "--help" || args[0] === "-h");
+}

package/dist/mcp.d.ts

@@ -8,4 +8,5 @@
  *
  * stdout is reserved for JSON-RPC; log only to stderr.
  */
+export declare function helpText(): string;
 export declare function main(): Promise<void>;

package/dist/mcp.js

@@ -21,6 +21,7 @@ import { removeModel } from "./rm.js";
 import { lastScan } from "./scan-store.js";
 import { scanNetwork } from "./scan.js";
 import { showModel } from "./show.js";
+import { isHelpFlag, printHelp } from "./argv.js";
 // Pin to the oldest widely-supported MCP revision. Clients may request a newer
 // date; we still answer with this — legal negotiation, max compatibility.
 const PROTOCOL_VERSION = "2024-11-05";
@@ -487,7 +488,29 @@ async function handleRequest(msg, version) {
             fail(id, -32601, `Method not found: ${method}`);
     }
 }
+export function helpText() {
+    return `Usage:
+  ollanet mcp
+
+Stdio MCP server (no extra npm deps). stdout is JSON-RPC; logs go to stderr.
+
+Tools:
+  ollanet_scan          Discover hosts + models (lan, all, last)
+  ollanet_prompt        Prompt a host or continue with chat_id
+  ollanet_compare       Same prompt on 2–5 models
+  ollanet_pull          Pull / update a model on a host
+  ollanet_show          Inspect a model
+  ollanet_rm            Delete a model (confirm: true)
+  ollanet_ps            Models loaded in VRAM
+  ollanet_list_chats    Saved transcripts
+  ollanet_get_chat      One chat by id
+
+Example Cursor config: { "command": "npx", "args": ["-y", "ollanet", "mcp"] }`;
+}
 export async function main() {
+    if (process.argv.slice(2).some((arg) => isHelpFlag(arg))) {
+        printHelp(helpText());
+    }
     const version = await packageVersion();
     console.error(`ollanet mcp ${version} (stdio) — tools: ${TOOLS.map((t) => t.name).join(", ")}`);
     const rl = createInterface({ input: process.stdin, crlfDelay: Infinity });

package/dist/prompt.d.ts

@@ -12,6 +12,7 @@
  *   ollanet chats
  */
 import { type AppConfig, type GenerateSettings } from "./config.js";
+export declare function helpText(): string;
 export interface PromptRunOptions {
     machine?: string;
     model?: string;

package/dist/prompt.js

@@ -17,14 +17,14 @@ import { configPath, defaultModelForHost, loadConfig, machineSettingsForHost, me
 import { envInt, findDiscoveredHost, ollamaBaseUrl, resolveHost, shortName, } from "./hosts.js";
 import { ollamaChat } from "./ollama-chat.js";
 import { assemblePrompt, readPromptFile } from "./prompt-input.js";
-import { consumeSettingsFlag, takeFlag, takeValue } from "./argv.js";
+import { consumeSettingsFlag, failUsage, isHelpFlag, printHelp, takeFlag, takeValue } from "./argv.js";
 import { listTargets, resolveTarget } from "./target.js";
 /** Prompt/chat HTTP timeout (ms). 0 = no timeout. Separate from scan's OLLAMA_TIMEOUT_MS. */
 function promptTimeoutMs() {
     return envInt("OLLAMA_PROMPT_TIMEOUT_MS", 600_000);
 }
-function usage() {
-    console.error(`Usage:
+export function helpText() {
+    return `Usage:
   ollanet prompt <machine> [model] <prompt...>
   ollanet prompt --chat <hash> <prompt...>
   ollanet prompt <machine> --chat <hash> <prompt...>
@@ -57,8 +57,10 @@ Options:
   --no-think             Disable thinking (default) so tokens go to the reply
   --file <path>          Prompt from a .txt or .md file (joins argv / stdin)
   --no-stream            Wait for the full response
-  --json                 Emit final response JSON (implies --no-stream)`);
-    process.exit(1);
+  --json                 Emit final response JSON (implies --no-stream)`;
+}
+function usage() {
+    failUsage(helpText());
 }
 /**
  * Heuristic for an optional positional model token.
@@ -136,8 +138,8 @@ function parseArgs(argv) {
         const arg = args.shift();
         if (arg === "--")
             continue;
-        if (arg === "--help" || arg === "-h")
-            usage();
+        if (isHelpFlag(arg))
+            printHelp(helpText());
         if (arg === "--no-stream") {
             stream = false;
             continue;

package/dist/ps.d.ts

@@ -5,6 +5,7 @@
  *   ollanet ps studio
  */
 import { type AppConfig } from "./config.js";
+export declare function helpText(): string;
 export interface LoadedModel {
     name: string;
     size_vram?: number;

package/dist/ps.js

@@ -7,14 +7,14 @@
 import { configFromPartial, loadConfig } from "./config.js";
 import { discoverHosts, envInt, ollamaBaseUrl, shortName, } from "./hosts.js";
 import { ollamaPs, ollamaPsRequired } from "./ollama-chat.js";
-import { takeFlag } from "./argv.js";
+import { failUsage, isHelpFlag, printHelp, takeFlag } from "./argv.js";
 import { resolveTarget } from "./target.js";
 import { looksTuned } from "./tuned.js";
 function psTimeoutMs() {
     return envInt("OLLAMA_PS_TIMEOUT_MS", 10_000);
 }
-function usage() {
-    console.error(`Usage:
+export function helpText() {
+    return `Usage:
   ollanet ps [machine]
   ollanet ps --machine <name>
 
@@ -27,8 +27,10 @@ scan lists models on disk. ps lists what is loaded in VRAM right now.
 
 Options:
   --machine <name>   One host (default: every discovered host)
-  --json             Emit result JSON on stdout`);
-    process.exit(1);
+  --json             Emit result JSON on stdout`;
+}
+function usage() {
+    failUsage(helpText());
 }
 function parseArgs(argv) {
     const args = [...argv];
@@ -39,8 +41,8 @@ function parseArgs(argv) {
         const arg = args.shift();
         if (arg === "--")
             continue;
-        if (arg === "--help" || arg === "-h")
-            usage();
+        if (isHelpFlag(arg))
+            printHelp(helpText());
         if (arg === "--json") {
             json = true;
             continue;

package/dist/pull.d.ts

@@ -8,6 +8,7 @@
  */
 import type { AppConfig } from "./config.js";
 import { type PullChunk } from "./ollama-chat.js";
+export declare function helpText(): string;
 export interface PullOptions {
     machine: string;
     model: string;

package/dist/pull.js

@@ -8,14 +8,14 @@
  */
 import { envInt, ollamaBaseUrl, shortName } from "./hosts.js";
 import { ollamaPull } from "./ollama-chat.js";
-import { takeFlag } from "./argv.js";
+import { failUsage, isHelpFlag, printHelp, takeFlag } from "./argv.js";
 import { resolveTarget } from "./target.js";
 /** Pull HTTP timeout (ms). 0 = none. Large models can take hours. */
 function pullTimeoutMs() {
     return envInt("OLLAMA_PULL_TIMEOUT_MS", 0);
 }
-function usage() {
-    console.error(`Usage:
+export function helpText() {
+    return `Usage:
   ollanet pull <machine> <model>
   ollanet pull --machine <name> --model <name>
 
@@ -33,8 +33,10 @@ Options:
   --model <name>     Model to pull (e.g. gemma3:12b)
   --insecure         Allow HTTP / self-signed model registries
   --no-stream        Wait for a single final response (no progress chunks)
-  --json             Emit result JSON on stdout`);
-    process.exit(1);
+  --json             Emit result JSON on stdout`;
+}
+function usage() {
+    failUsage(helpText());
 }
 function parseArgs(argv) {
     const args = [...argv];
@@ -48,8 +50,8 @@ function parseArgs(argv) {
         const arg = args.shift();
         if (arg === "--")
             continue;
-        if (arg === "--help" || arg === "-h")
-            usage();
+        if (isHelpFlag(arg))
+            printHelp(helpText());
         if (arg === "--insecure") {
             insecure = true;
             continue;

package/dist/rm.d.ts

@@ -4,6 +4,7 @@
  *   ollanet rm studio llama3.2:1b --yes
  */
 import type { AppConfig } from "./config.js";
+export declare function helpText(): string;
 export interface RemoveOptions {
     machine: string;
     model: string;

package/dist/rm.js

@@ -6,13 +6,13 @@
 import { createInterface } from "node:readline";
 import { envInt, ollamaBaseUrl, shortName } from "./hosts.js";
 import { ollamaDelete } from "./ollama-chat.js";
-import { takeFlag } from "./argv.js";
+import { failUsage, isHelpFlag, printHelp, takeFlag } from "./argv.js";
 import { resolveTarget } from "./target.js";
 function rmTimeoutMs() {
     return envInt("OLLAMA_RM_TIMEOUT_MS", 30_000);
 }
-function usage() {
-    console.error(`Usage:
+export function helpText() {
+    return `Usage:
   ollanet rm <machine> <model> --yes
   ollanet rm --machine <name> --model <name> --yes
 
@@ -27,8 +27,10 @@ Options:
   --machine <name>   Host (discovered name, MagicDNS, hostname, or IP[:port])
   --model <name>     Model to delete
   --yes              Required unless stdin is a TTY and you confirm
-  --json             Emit result JSON on stdout`);
-    process.exit(1);
+  --json             Emit result JSON on stdout`;
+}
+function usage() {
+    failUsage(helpText());
 }
 function parseArgs(argv) {
     const args = [...argv];
@@ -41,8 +43,8 @@ function parseArgs(argv) {
         const arg = args.shift();
         if (arg === "--")
             continue;
-        if (arg === "--help" || arg === "-h")
-            usage();
+        if (isHelpFlag(arg))
+            printHelp(helpText());
         if (arg === "--yes" || arg === "-y") {
             yes = true;
             continue;

package/dist/scan.d.ts

@@ -54,4 +54,5 @@ export interface ScanPayload {
 }
 /** Programmatic scan used by CLI `--json`, MCP, and `import { scanNetwork } from "ollanet"`. */
 export declare function scanNetwork(options?: ScanOptions): Promise<ScanPayload>;
+export declare function helpText(): string;
 export declare function main(): Promise<void>;

package/dist/scan.js

@@ -7,6 +7,7 @@ import { configFromPartial, loadConfig } from "./config.js";
 import { discoverHosts, envInt, ollamaPort, shortName, } from "./hosts.js";
 import { lastScanPath, loadLastScan, saveLastScan } from "./scan-store.js";
 import { looksTuned } from "./tuned.js";
+import { isHelpFlag, printHelp } from "./argv.js";
 function scanTimeoutMs() {
     return envInt("OLLAMA_TIMEOUT_MS", 2500);
 }
@@ -184,7 +185,30 @@ export async function scanNetwork(options = {}) {
     }
     return payload;
 }
+export function helpText() {
+    return `Usage:
+  ollanet scan [--json] [--all] [--lan] [--last]
+
+Examples:
+  ollanet scan
+  ollanet scan --lan
+  ollanet scan --last
+  ollanet scan --json
+
+Discovers Ollama hosts (localhost, config, OLLANET_HOSTS, Tailscale) and lists
+models. --lan is an opt-in TCP sweep of local /24s on port 11434.
+
+Options:
+  --json     Machine-readable output
+  --all      Also probe offline Tailscale peers
+  --lan      TCP-scan local LAN CIDRs for open Ollama ports
+  --last     Reprint the last saved scan (no network)
+  --cached   Same as --last`;
+}
 export async function main() {
+    if (process.argv.slice(2).some((arg) => isHelpFlag(arg))) {
+        printHelp(helpText());
+    }
     const includeOffline = process.argv.includes("--all");
     const jsonOut = process.argv.includes("--json");
     const lanScan = process.argv.includes("--lan");

package/dist/show.d.ts

@@ -5,6 +5,7 @@
  */
 import { type OllamaShowInfo } from "./ollama-chat.js";
 import type { AppConfig } from "./config.js";
+export declare function helpText(): string;
 export interface ShowOptions {
     machine: string;
     model: string;

package/dist/show.js

@@ -5,14 +5,14 @@
  */
 import { envInt, ollamaBaseUrl, shortName } from "./hosts.js";
 import { ollamaShow } from "./ollama-chat.js";
-import { takeFlag } from "./argv.js";
+import { failUsage, isHelpFlag, printHelp, takeFlag } from "./argv.js";
 import { resolveTarget } from "./target.js";
 import { looksTuned } from "./tuned.js";
 function showTimeoutMs() {
     return envInt("OLLAMA_SHOW_TIMEOUT_MS", 30_000);
 }
-function usage() {
-    console.error(`Usage:
+export function helpText() {
+    return `Usage:
   ollanet show <machine> <model>
   ollanet show --machine <name> --model <name>
 
@@ -26,8 +26,10 @@ Tuned Finetuna-style names are marked [tuned].
 Options:
   --machine <name>   Host (discovered name, MagicDNS, hostname, or IP[:port])
   --model <name>     Model to inspect
-  --json             Emit result JSON on stdout`);
-    process.exit(1);
+  --json             Emit result JSON on stdout`;
+}
+function usage() {
+    failUsage(helpText());
 }
 function parseArgs(argv) {
     const args = [...argv];
@@ -39,8 +41,8 @@ function parseArgs(argv) {
         const arg = args.shift();
         if (arg === "--")
             continue;
-        if (arg === "--help" || arg === "-h")
-            usage();
+        if (isHelpFlag(arg))
+            printHelp(helpText());
         if (arg === "--json") {
             json = true;
             continue;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ollanet",
-  "version": "0.6.1",
+  "version": "0.6.2",
   "description": "Discover and talk to Ollama on any reachable network — CLI, MCP, and a Node library",
   "type": "module",
   "bin": {