@bytevion/cli 0.4.0 → 0.4.1

package/bin/postinstall.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+// Friendly, best-effort post-install notice. It must NEVER fail or block the install,
+// so everything is wrapped and falls back to plain output. Its only job is to tell the
+// user how to start — and to warn when another program named `byte` already owns that
+// name on the PATH (a common clash with a stale Python `byte.exe`), pointing them at the
+// collision-proof `bytevion` command, which is the same CLI.
+
+function colors() {
+  try {
+    return require('picocolors')
+  } catch {
+    const id = (s) => s
+    return { cyan: id, bold: id, dim: id, yellow: id }
+  }
+}
+
+// On Windows, return the path of a `byte.exe` that shadows our `byte.cmd` shim, if any.
+// Our npm shim is always `.cmd`/`.ps1`, never `.exe`, so a first-hit `.exe` means another
+// tool wins when the user types `byte`.
+function shadowingExe() {
+  if (process.platform !== 'win32') return null
+  try {
+    const { execFileSync } = require('node:child_process')
+    const out = execFileSync('where', ['byte'], { encoding: 'utf8', stdio: ['ignore', 'pipe', 'ignore'] })
+    const first = out
+      .split(/\r?\n/)
+      .map((s) => s.trim())
+      .filter(Boolean)[0]
+    return first && first.toLowerCase().endsWith('.exe') ? first : null
+  } catch {
+    return null
+  }
+}
+
+try {
+  // Skip the banner in CI / non-interactive installs to keep logs clean.
+  if (process.env.CI || process.env.BYTE_NO_POSTINSTALL === '1') process.exit(0)
+
+  const c = colors()
+  const mark = `${c.dim('>')}${c.bold(c.cyan('b'))}${c.dim('_')}`
+  const lines = ['']
+  lines.push(`  ${mark}  ${c.bold('Byte')} is installed.`)
+  lines.push(`  ${c.dim('Get started:')}  ${c.cyan('byte login')}  ${c.dim('then')}  ${c.cyan('byte setup')}`)
+
+  const shadow = shadowingExe()
+  if (shadow) {
+    lines.push('')
+    lines.push(`  ${c.yellow('!')} ${c.dim('Another program already owns')} ${c.bold('byte')} ${c.dim('on your PATH:')}`)
+    lines.push(`      ${c.dim(shadow)}`)
+    lines.push(`  ${c.dim('Use the')} ${c.cyan('bytevion')} ${c.dim('command instead — it is the same CLI:')}  ${c.cyan('bytevion login')}`)
+  } else {
+    lines.push(`  ${c.dim('(If')} ${c.cyan('byte')} ${c.dim('is taken by another tool, the')} ${c.cyan('bytevion')} ${c.dim('command works too.)')}`)
+  }
+  lines.push('')
+  process.stdout.write(lines.join('\n') + '\n')
+} catch {
+  // Never let a notice break an install.
+}

package/oclif.manifest.json

@@ -1199,14 +1199,10 @@
         "rotate.js"
       ]
     },
-    "providers:add": {
+    "sessions": {
       "aliases": [],
       "args": {},
-      "description": "Connect an upstream provider key (BYOK). Byte stores it encrypted and imports models.",
-      "examples": [
-        "<%= config.bin %> providers add --provider deepseek --api-key sk-...",
-        "<%= config.bin %> providers add --provider custom --provider-base-url https://api.example.com/v1 --api-key ..."
-      ],
+      "description": "List active terminal sessions (CLI tokens) for the org.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1230,53 +1226,11 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
-        },
-        "provider": {
-          "description": "Provider preset id (openai, deepseek, anthropic, …)",
-          "name": "provider",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-key": {
-          "description": "Upstream provider API key",
-          "env": "BYTE_PROVIDER_KEY",
-          "name": "api-key",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "provider-base-url": {
-          "description": "Custom base URL (for --provider custom or to override)",
-          "name": "provider-base-url",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "mode": {
-          "description": "Gateway mode (byte_compatible/byte_messages/byte_generative)",
-          "name": "mode",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "label": {
-          "description": "Label for this connection",
-          "name": "label",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "no-fetch": {
-          "description": "Skip auto-importing the model list",
-          "name": "no-fetch",
-          "allowNo": false,
-          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:add",
+      "id": "sessions",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1286,14 +1240,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "providers",
-        "add.js"
+        "sessions",
+        "index.js"
       ]
     },
-    "providers:list": {
+    "sessions:revoke": {
       "aliases": [],
-      "args": {},
-      "description": "List upstream provider connections for the current org.",
+      "args": {
+        "id": {
+          "description": "Session id (see `byte sessions`)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Revoke a terminal session (CLI token) by id.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1321,7 +1281,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:list",
+      "id": "sessions:revoke",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1331,20 +1291,18 @@
       "relativePath": [
         "dist",
         "commands",
-        "providers",
-        "list.js"
+        "sessions",
+        "revoke.js"
       ]
     },
-    "providers:rotate": {
+    "providers:add": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Connection id (see `byte providers list`)",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Replace the upstream API key on a provider connection (keeps imported models).",
+      "args": {},
+      "description": "Connect an upstream provider key (BYOK). Byte stores it encrypted and imports models.",
+      "examples": [
+        "<%= config.bin %> providers add --provider deepseek --api-key sk-...",
+        "<%= config.bin %> providers add --provider custom --provider-base-url https://api.example.com/v1 --api-key ..."
+      ],
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1369,18 +1327,52 @@
           "multiple": false,
           "type": "option"
         },
+        "provider": {
+          "description": "Provider preset id (openai, deepseek, anthropic, …)",
+          "name": "provider",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
         "api-key": {
-          "description": "New upstream provider API key",
+          "description": "Upstream provider API key",
           "env": "BYTE_PROVIDER_KEY",
           "name": "api-key",
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "provider-base-url": {
+          "description": "Custom base URL (for --provider custom or to override)",
+          "name": "provider-base-url",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "mode": {
+          "description": "Gateway mode (byte_compatible/byte_messages/byte_generative)",
+          "name": "mode",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "label": {
+          "description": "Label for this connection",
+          "name": "label",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
+        },
+        "no-fetch": {
+          "description": "Skip auto-importing the model list",
+          "name": "no-fetch",
+          "allowNo": false,
+          "type": "boolean"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:rotate",
+      "id": "providers:add",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1391,19 +1383,13 @@
         "dist",
         "commands",
         "providers",
-        "rotate.js"
+        "add.js"
       ]
     },
-    "providers:test": {
+    "providers:list": {
       "aliases": [],
-      "args": {
-        "id": {
-          "description": "Connection id (see `byte providers list`)",
-          "name": "id",
-          "required": true
-        }
-      },
-      "description": "Verify a provider connection by re-fetching its model list.",
+      "args": {},
+      "description": "List upstream provider connections for the current org.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1431,7 +1417,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "providers:test",
+      "id": "providers:list",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1442,13 +1428,19 @@
         "dist",
         "commands",
         "providers",
-        "test.js"
+        "list.js"
       ]
     },
-    "sessions": {
+    "providers:rotate": {
       "aliases": [],
-      "args": {},
-      "description": "List active terminal sessions (CLI tokens) for the org.",
+      "args": {
+        "id": {
+          "description": "Connection id (see `byte providers list`)",
+          "name": "id",
+          "required": true
+        }
+      },
+      "description": "Replace the upstream API key on a provider connection (keeps imported models).",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1472,11 +1464,19 @@
           "hasDynamicHelp": false,
           "multiple": false,
           "type": "option"
+        },
+        "api-key": {
+          "description": "New upstream provider API key",
+          "env": "BYTE_PROVIDER_KEY",
+          "name": "api-key",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions",
+      "id": "providers:rotate",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1486,20 +1486,20 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "index.js"
+        "providers",
+        "rotate.js"
       ]
     },
-    "sessions:revoke": {
+    "providers:test": {
       "aliases": [],
       "args": {
         "id": {
-          "description": "Session id (see `byte sessions`)",
+          "description": "Connection id (see `byte providers list`)",
           "name": "id",
           "required": true
         }
       },
-      "description": "Revoke a terminal session (CLI token) by id.",
+      "description": "Verify a provider connection by re-fetching its model list.",
       "flags": {
         "json": {
           "description": "Format output as json.",
@@ -1527,7 +1527,7 @@
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "sessions:revoke",
+      "id": "providers:test",
       "pluginAlias": "@bytevion/cli",
       "pluginName": "@bytevion/cli",
       "pluginType": "core",
@@ -1537,8 +1537,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "sessions",
-        "revoke.js"
+        "providers",
+        "test.js"
       ]
     },
     "opt:preset": {
@@ -1711,5 +1711,5 @@
       ]
     }
   },
-  "version": "0.4.0"
+  "version": "0.4.1"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bytevion/cli",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "Byte — control your LLM optimization gateway from the terminal.",
   "author": "Byte",
   "license": "UNLICENSED",
@@ -8,7 +8,8 @@
     "access": "public"
   },
   "bin": {
-    "byte": "./bin/run.js"
+    "byte": "./bin/run.js",
+    "bytevion": "./bin/run.js"
   },
   "type": "commonjs",
   "engines": {
@@ -74,6 +75,7 @@
   },
   "scripts": {
     "build": "tsc -b && node scripts/tui-pkg.js && oclif manifest",
+    "postinstall": "node ./bin/postinstall.js",
     "test": "npm run build && npm run test:unit && npm run test:tui",
     "test:unit": "tsx --test \"src/**/*.test.ts\" \"src/**/*.test.tsx\"",
     "test:tui": "node --test \"src/**/*.test.mts\"",