@model-go/cli 0.1.1 → 0.1.2

package/README.md

@@ -2,7 +2,7 @@
 
 The official CLI for modelgo. Pairs with AI agent skills (Claude Code, Codex, Gemini CLI, etc.) so AI agents can operate modelgo on your behalf.
 
-> **v0 framework stage.** Business APIs are not wired up yet; the only command is `hello` (a demo to verify the install pipeline).
+> **v0 framework stage.** The demo `hello` command and device-flow `auth` commands are available. API key, usage, and model gateway commands are not wired up yet.
 
 ## Install
 
@@ -12,23 +12,81 @@ npx @model-go/cli@latest install
 
 This runs an interactive wizard that:
 
-1. Installs `@model-go/cli` globally via npm (which downloads the Go binary from GitHub Releases).
+1. Installs `@model-go/cli` globally via npm (which downloads the Go binary from GitHub Releases as `modelgo`).
 2. Distributes `modelgo-*` skills to every AI agent installed on your machine (Claude Code, Trae, Trae CN, and other agents in the [skills](https://www.npmjs.com/package/skills) ecosystem).
 
 After install, restart your AI agent (open a new chat / session) and try:
 
-> "Have modelgo-cli say hello to me."
+> "Have modelgo say hello to me."
 
-Your AI should find the `modelgo-hello` skill and run `modelgo-cli hello`.
+Your AI should find the `modelgo-hello` skill and run `modelgo hello`.
 
 ## Direct commands
 
 ```bash
-modelgo-cli --version
-modelgo-cli hello [--name NAME]
-modelgo-cli --help
+modelgo --version
+modelgo auth login
+modelgo auth status
+modelgo auth logout
+modelgo hello [--name NAME]
+modelgo --help
 ```
 
+`modelgo auth login` without `--no-wait` is a blocking command: it prints the
+authorization URL, then keeps polling until the browser approval completes or
+the device code expires.
+
+### Environments
+
+The CLI talks to a named environment. Two are built in:
+
+| Env    | Base URL                     |
+| ------ | ---------------------------- |
+| `cn`   | `https://api.modelgo.com`    |
+| `intl` | `https://api.modelgo.global` |
+
+The active environment defaults to `cn`. Switch it, or register your own:
+
+```bash
+modelgo env list                 # show built-in + custom envs (active marked with *)
+modelgo env current              # print the active env
+modelgo env use intl             # switch the active env
+modelgo env add <name> --base-url https://...   # register or override an env URL
+modelgo env remove <name>        # remove a custom env or override
+```
+
+Environment definitions and the active selection live in `~/.modelgo/config.json`.
+Credentials are stored per-env in `~/.modelgo/auth.json`, so switching environments
+preserves each login. There are no environment variables to set.
+
+Auth commands operate on the active env; pass `--env <name>` to target a different one:
+
+```bash
+modelgo auth login --env intl
+modelgo auth status --env intl
+modelgo auth logout --all          # clear every env
+```
+
+### Non-streaming agent flows
+
+For AI-agent harnesses that cannot stream intermediate output to the user, use:
+
+```bash
+modelgo auth login --no-wait --json
+modelgo auth login --device-code <DEVICE_CODE>
+```
+
+Do not show the URL and then immediately block on `--device-code` in the same
+turn. In final-message-only harnesses, that pattern prevents the user from ever
+seeing the URL before the agent starts waiting.
+
+> **`--json` emits newline-delimited JSON (NDJSON).** In the default waiting
+> flow (`modelgo auth login --json` without `--no-wait`), stdout receives two
+> JSON objects: first the device-code object (with `verification_url`), then
+> the authenticated object once approved. Parse line by line — don't
+> `JSON.parse` the whole stream. With `--no-wait`, only the device-code object
+> is printed.
+
 ## Upgrade
 
 Re-run the installer; it detects an out-of-date install and upgrades in place:

package/checksums.txt

@@ -1,6 +1,6 @@
-769fac4456815aeabc8517827df7d174b650e2d6d127eb7805aec3477179cd23  modelgo-cli-0.1.1-darwin-amd64.tar.gz
-5720ad47e70b7ad5a99688f47c7c345ee8a3e6306fbea7510276398011815801  modelgo-cli-0.1.1-darwin-arm64.tar.gz
-f4f46f11be9a485e8e12e26bb1c8f9b67c02d67466b46c96be32a4557c951ca4  modelgo-cli-0.1.1-linux-amd64.tar.gz
-7482afffe11cf8bf3c8798d77166ce5a6c0b79acdd53c030712b9b4fc69a0521  modelgo-cli-0.1.1-linux-arm64.tar.gz
-c86b6da335e95354b0cfe2b8bc11cd4b2fbeff5a32231c9fdef0a55440659bf1  modelgo-cli-0.1.1-windows-amd64.zip
-1f101449e834ff876ccc418d246e8b06b2a21031904d8c638066e0d6e1c52eb2  modelgo-cli-0.1.1-windows-arm64.zip
+818fc80cdbb471fe9abd2373c30795f4a138f4be4c812cdb3d25148b71a131ed  modelgo-0.1.2-darwin-amd64.tar.gz
+cb981e35d3652d2b0e3d50c0f0eadfd8ee1497887d1e529f7630581c8cfb29e5  modelgo-0.1.2-darwin-arm64.tar.gz
+974822455dd0b423e91a096b00fb6d28750f42ceb982185a434d14d6396974dd  modelgo-0.1.2-linux-amd64.tar.gz
+f388c0e1d23df86a24650b7bcbd2424b5a232b81a0a3f7bb426ad31781fa1217  modelgo-0.1.2-linux-arm64.tar.gz
+5d96a2409132650dd4a98dcc8d1d0f44d519fde5de816550e53db7aba6ae629a  modelgo-0.1.2-windows-amd64.zip
+ea37a1341c87afd2f3cddfe5027a3e8203532cf5432b329c6caa8b4ce506cc05  modelgo-0.1.2-windows-arm64.zip

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "@model-go/cli",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "The official CLI for modelgo. Pairs with AI agent skills so AI agents can operate modelgo on your behalf.",
   "bin": {
-    "modelgo-cli": "scripts/run.js"
+    "modelgo": "scripts/run.js"
   },
   "scripts": {
     "postinstall": "node scripts/install.js",

package/scripts/install-wizard.js

@@ -7,6 +7,11 @@ const p = require("@clack/prompts");
 const { semverLessThan } = require("./install.js");
 
 const PKG = "@model-go/cli";
+// PKG_VERSION is the version of the wizard CURRENTLY EXECUTING. The wizard
+// pins step1's `npm install -g` to this exact version so that
+// `npx @model-go/cli@rc install` installs the rc version globally,
+// not whatever the @latest dist-tag happens to resolve to.
+const PKG_VERSION = require("../package.json").version;
 const SKILLS_REPO = "modelgo/modelgo-cli";
 const isWindows = process.platform === "win32";
 
@@ -26,7 +31,7 @@ const messages = {
     step2Spinner:  "正在安装 Skills...",
     step2Done:     "Skills 已安装",
     step2Fail:     "Skills 安装失败。运行以下命令重试: npx skills add %s -y -g",
-    done:          "安装完成！\n试试跟你的 AI 工具（Claude Code、Codex 等）说：\"用 modelgo-cli 跟我打个招呼\"",
+    done:          "安装完成！\n试试跟你的 AI 工具（Claude Code、Codex 等）说：\"用 modelgo 跟我打个招呼\"",
     cancelled:     "安装已取消",
     nonTtyHint:    "非交互模式，已完成 npm 全局安装 + skills 安装。",
   },
@@ -41,7 +46,7 @@ const messages = {
     step2Spinner:  "Installing skills...",
     step2Done:     "Skills installed",
     step2Fail:     "Failed to install skills. Run manually: npx skills add %s -y -g",
-    done:          "You are all set!\nTry asking your AI tool (Claude Code, Codex, etc.): \"Have modelgo-cli say hello to me\"",
+    done:          "You are all set!\nTry asking your AI tool (Claude Code, Codex, etc.): \"Have modelgo say hello to me\"",
     cancelled:     "Installation cancelled",
     nonTtyHint:    "Non-interactive mode. Completed global install + skills install.",
   },
@@ -78,16 +83,6 @@ function fmt(template, ...values) {
   return template.replace(/%s/g, () => values[i++] ?? "");
 }
 
-function getLatestVersion() {
-  try {
-    const out = runSilent("npm", ["view", PKG, "version"], { timeout: 15000 });
-    const ver = out.toString().trim();
-    return /^\d+\.\d+\.\d+/.test(ver) ? ver : null;
-  } catch (_) {
-    return null;
-  }
-}
-
 function getGloballyInstalledVersion() {
   try {
     const out = runSilent("npm", ["list", "-g", PKG], { timeout: 15000 });
@@ -162,8 +157,7 @@ function reportFail(isInteractive, spinner, message, err) {
 
 async function stepInstallGlobally(msg, isInteractive) {
   const installedVer = getGloballyInstalledVersion();
-  const latestVer = getLatestVersion();
-  const needsUpgrade = installedVer && latestVer && semverLessThan(installedVer, latestVer);
+  const needsUpgrade = installedVer && semverLessThan(installedVer, PKG_VERSION);
 
   if (installedVer && !needsUpgrade) {
     const skipMsg = fmt(msg.step1Skip, installedVer);
@@ -173,13 +167,16 @@ async function stepInstallGlobally(msg, isInteractive) {
   }
 
   const startMsg = needsUpgrade
-    ? fmt(msg.step1Upgrade, PKG, installedVer, latestVer)
+    ? fmt(msg.step1Upgrade, PKG, installedVer, PKG_VERSION)
     : fmt(msg.step1, PKG);
-  const doneMsg = needsUpgrade ? fmt(msg.step1Upgraded, latestVer) : msg.step1Done;
+  const doneMsg = needsUpgrade ? fmt(msg.step1Upgraded, PKG_VERSION) : msg.step1Done;
 
   const s = reportStart(isInteractive, startMsg);
   try {
-    await runSilentAsync("npm", ["install", "-g", PKG], { timeout: 120000 });
+    // Pin to PKG_VERSION (the wizard's own version) so that
+    // `npx @model-go/cli@rc install` installs the rc version globally,
+    // not whatever the @latest dist-tag currently resolves to.
+    await runSilentAsync("npm", ["install", "-g", `${PKG}@${PKG_VERSION}`], { timeout: 120000 });
     reportStop(isInteractive, s, doneMsg);
   } catch (err) {
     reportFail(isInteractive, s, fmt(msg.step1Fail, PKG), err);

package/scripts/install.js

@@ -9,7 +9,7 @@ const crypto = require("crypto");
 
 const VERSION = require("../package.json").version;
 const REPO = "modelgo/modelgo-cli";
-const NAME = "modelgo-cli";
+const NAME = "modelgo";
 const DEFAULT_MIRROR_HOST = "https://registry.npmmirror.com";
 
 // Allowlist gates the initial request host. curl --location follows redirects
@@ -224,7 +224,7 @@ function install() {
   const downloadUrls = [GITHUB_URL, ...mirrorUrls];
 
   fs.mkdirSync(binDir, { recursive: true });
-  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "modelgo-cli-"));
+  const tmpDir = fs.mkdtempSync(path.join(os.tmpdir(), "modelgo-"));
   const archivePath = path.join(tmpDir, archiveName);
 
   try {

package/scripts/run.js

@@ -3,8 +3,8 @@
 // SPDX-License-Identifier: MIT
 //
 // npm bin entrypoint. Routes:
-//   - `modelgo-cli install`  → install-wizard.js (interactive setup)
-//   - everything else        → exec bin/modelgo-cli (the downloaded Go binary)
+//   - `modelgo install`  → install-wizard.js (interactive setup)
+//   - everything else    → exec bin/modelgo (the downloaded Go binary)
 
 const { execFileSync } = require("child_process");
 const path = require("path");
@@ -16,12 +16,12 @@ if (args[0] === "install") {
   require("./install-wizard.js");
 } else {
   const isWindows = process.platform === "win32";
-  const binName = "modelgo-cli" + (isWindows ? ".exe" : "");
+  const binName = "modelgo" + (isWindows ? ".exe" : "");
   const binPath = path.join(__dirname, "..", "bin", binName);
 
   if (!fs.existsSync(binPath)) {
     console.error(
-      `modelgo-cli binary not found at ${binPath}\n` +
+      `modelgo binary not found at ${binPath}\n` +
       `Please reinstall: npm install -g @model-go/cli`
     );
     process.exit(1);