@murongg/aah-cli 0.1.3 → 0.1.5

package/README.md

@@ -10,6 +10,20 @@ npm install -g @murongg/aah-cli
 
 The npm package has its own standalone CLI version and downloads the matching prebuilt native binary from the `cli-vX.Y.Z` GitHub Release during installation.
 
+On macOS or Linux, you can install the standalone Release binary without npm:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/murongg/ai-accounts-hub/main/scripts/install-aah.sh | sh
+```
+
+Pin a version or install into another directory:
+
+```bash
+curl -fsSL https://raw.githubusercontent.com/murongg/ai-accounts-hub/main/scripts/install-aah.sh -o install-aah.sh
+AAH_VERSION=0.1.3 sh install-aah.sh
+AAH_INSTALL_DIR=/usr/local/bin sh install-aah.sh
+```
+
 Publishing from GitHub Actions requires the repository secret `NPM_TOKEN` to be an npm Automation token when the npm account has publish 2FA enabled. A regular publish token will fail with `EOTP` because CI cannot provide a one-time password.
 
 ## Usage
@@ -31,12 +45,18 @@ TUI shortcuts:
 Run script-friendly commands:
 
 ```bash
+aah add --provider codex
 aah list
 aah current
 aah refresh
+aah upgrade
 aah switch --provider codex user@example.com
 ```
 
+`aah add --provider ...` starts the provider's login flow, stores the account in the managed account pool, and leaves the current active CLI account unchanged.
+
+`aah upgrade` checks the latest `cli-vX.Y.Z` release, auto-detects how the CLI was installed, and upgrades in place when safe. On older installs that do not have install metadata yet, it may print a one-line manual upgrade command instead of upgrading directly.
+
 Filter by provider:
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@murongg/aah-cli",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "description": "Standalone AI Accounts Hub CLI",
   "type": "module",
   "license": "MIT",

package/scripts/postinstall.mjs

@@ -32,6 +32,50 @@ export function releaseTagForVersion(version) {
   return `cli-v${version}`;
 }
 
+export function installMetadataPathForEnv(env = process.env, platform = process.platform) {
+  if (platform === "win32") {
+    const appData = env.APPDATA;
+    if (!appData) {
+      throw new Error("APPDATA is required on Windows");
+    }
+    return path.join(appData, "aah", "cli-install.json");
+  }
+
+  const home = env.HOME ?? os.homedir();
+  const configRoot = env.XDG_CONFIG_HOME ?? path.join(home, ".config");
+  return path.join(configRoot, "aah", "cli-install.json");
+}
+
+export function detectPackageManagerFromEnv(env = process.env) {
+  const userAgent = env.npm_config_user_agent ?? "";
+  if (userAgent.startsWith("pnpm/")) {
+    return "pnpm";
+  }
+  if (userAgent.startsWith("yarn/")) {
+    return "yarn";
+  }
+  if (userAgent.startsWith("bun/")) {
+    return "bun";
+  }
+  return "npm";
+}
+
+export function writeInstallMetadata(packageRoot, env = process.env, platform = process.platform) {
+  const metadataPath = installMetadataPathForEnv(env, platform);
+  const binaryPath = binaryPathForPackage(packageRoot, platform);
+  const metadata = {
+    schema_version: 1,
+    install_method: "package-manager",
+    package_manager: detectPackageManagerFromEnv(env),
+    package_name: "@murongg/aah-cli",
+    binary_path: binaryPath,
+    installed_at: new Date().toISOString(),
+  };
+
+  fs.mkdirSync(path.dirname(metadataPath), { recursive: true });
+  fs.writeFileSync(metadataPath, JSON.stringify(metadata, null, 2));
+}
+
 function download(url, targetPath) {
   return new Promise((resolve, reject) => {
     https
@@ -80,6 +124,8 @@ async function main() {
   if (process.platform !== "win32") {
     fs.chmodSync(binaryPath, 0o755);
   }
+
+  writeInstallMetadata(packageRoot);
 }
 
 if (process.argv[1] && import.meta.url === new URL(process.argv[1], "file:").href) {