@hemansubedi/aether-ai 1.0.0 → 1.0.1

package/README.md

@@ -43,6 +43,36 @@ Aether is a TypeScript CLI agent that turns your terminal into an autonomous cod
 
 Aether installs like KiloCode and runs like Claude Code. One line, no setup beyond Node.js 20+.
 
+### CLI flags
+
+`aether-ai` understands standard flags before the prompt:
+
+| Flag | Description |
+|------|-------------|
+| `-v`, `--version` | Print the version (`aether-ai 1.0.0`) and exit |
+| `-h`, `--help` | Print the help text (same as `/help`) and exit |
+| `--plan` | Start in plan mode (step-by-step approval) |
+| `--yolo` | Start in yolo mode (autonomous execution) |
+| `--no-stream` | Disable streaming output in one-shot mode |
+
+```text
+$ aether-ai --version
+aether-ai 1.0.0
+
+$ aether-ai --help
+Aether - the free, unlimited, multi-provider LLM CLI
+
+Usage: aether-ai [options] [prompt]
+
+Options:
+  -h, --help        Show this help text and exit
+  -v, --version     Print the version and exit
+  --plan            Run in plan mode (step-by-step approval)
+  --yolo            Run in yolo mode (autonomous execution)
+  --no-stream       Disable streaming output in one-shot mode
+```
+
+Flags are parsed from `process.argv` before the remaining args are treated as the prompt, so `aether-ai --yolo "fix the tests"` runs the prompt in yolo mode.
 ### Install
 
 | Platform | Command |
@@ -72,7 +102,7 @@ $ npx tsx src/index.ts
 
 +- Aether --------------------------------------------------+
 |                                                           |
-|  ollama-local · qwen2.5:7b                                |
+|  ollama-local · qwen2.5:7b                                |
 |                                                           |
 |  ? Build a REST API in Node.js with CRUD endpoints         |
 |                                                           |
@@ -97,16 +127,16 @@ $ npx tsx src/index.ts /arena
 
   ? Prompt: write a hello world server
   ? Running 3 models in parallel...
-  ? [Model A] ollama-local · qwen2.5:7b
-  ? [Model B] openrouter-free · llama-3.1-8b:free
-  ? [Model C] groq · llama-3.1-8b-instant
+  ? [Model A] ollama-local · qwen2.5:7b
+  ? [Model B] openrouter-free · llama-3.1-8b:free
+  ? [Model C] groq · llama-3.1-8b-instant
   ? Voting...
   ? Winner: Model A (Elo +12)
 
   ELO LEADERBOARD
-  1. Model A    1240  ████████████
-  2. Model B    1215  ██████████
-  3. Model C    1142  ████████
+  1. Model A    1240  ████████████
+  2. Model B    1215  ██████████
+  3. Model C    1142  ████████
 ```
 
 Session stats:
@@ -353,6 +383,7 @@ Add in local-first Ollama (priority 1, zero cost), zero-install one-shot mode (`
 [MIT License](LICENSE) -- built by [Hemansubedi10](https://github.com/hemansubedi10).
 
 Full docs: [docs/aether.md](docs/aether.md) | [INSTALL.md](INSTALL.md) | [Report an issue](https://github.com/hemansubedi10/aether/issues)
+
 ## Install via npm
 
 ```bash
@@ -360,31 +391,13 @@ npm install -g aether-ai
 aether-ai "your prompt"
 ```
 
-The package is published on npm: [npmjs.com/package/aether](https://www.npmjs.com/package/aether-ai).
-
-## Install
-
-Install the Aether CLI globally:
-
-bash
-npm install -g aether-ai
-
-
+The package is published on npm: [npmjs.com/package/aether-ai](https://www.npmjs.com/package/aether-ai).
 
 ## Publishing
 
-Aether is published on npm as **`aether-ai`**. Install it globally with:
-
-```bash
-npm install -g aether-ai
-aether-ai "your prompt"
-```
-
-Package page: [npmjs.com/package/aether-ai](https://www.npmjs.com/package/aether-ai).
-
-### Trusted Publishing (OIDC � no token needed)
+Aether is published on npm as **`aether-ai`**. New versions are published automatically by a GitHub Actions workflow using npm **Trusted Publishing**. There is no npm token to manage — GitHub Actions authenticates to npm via OpenID Connect.
 
-New versions are published automatically by a GitHub Actions workflow using npm **Trusted Publishing**. There is no npm token to manage � GitHub Actions authenticates to npm via OpenID Connect.
+### Trusted Publishing (OIDC - no token needed)
 
 To release a new version:
 

package/dist/index.js

@@ -169,13 +169,49 @@ import { GitTool } from "./git.js";
 import { Checkpoint } from "./checkpoint.js";
 import { Skills } from "./skills.js";
 // CLI entrypoint
+const VERSION = "1.0.0";
+function getHelpText() {
+    const lines = [];
+    lines.push("Aether - the free, unlimited, multi-provider LLM CLI");
+    lines.push("");
+    lines.push("Usage: aether-ai [options] [prompt]");
+    lines.push("");
+    lines.push("Options:");
+    lines.push("  -h, --help        Show this help text and exit");
+    lines.push("  -v, --version     Print the version and exit");
+    lines.push("  --plan            Run in plan mode (step-by-step approval)");
+    lines.push("  --yolo            Run in yolo mode (autonomous execution)");
+    lines.push("  --no-stream       Disable streaming output in one-shot mode");
+    lines.push("");
+    lines.push("Commands (prefix a prompt with /):");
+    lines.push("  /help             Show all available commands");
+    lines.push("  /model <name>     Switch the active model");
+    lines.push("  /provider <name>  Switch the active provider");
+    lines.push("  /models           List all available models across providers");
+    lines.push("  /providers        Show provider health status");
+    lines.push("  /combo ...        Manage named provider/model combos");
+    lines.push("  /session ...      Manage sessions");
+    lines.push("  /arena            Enter arena mode (compare models)");
+    lines.push("  /cost             Show token usage and estimated cost summary");
+    lines.push("  /stats            Show session stats, cost summary, and provider health");
+    lines.push("  /skills           List available custom skills");
+    lines.push("  /connect ...      Connect an API key for a provider");
+    lines.push("  /exit             Exit the TUI");
+    lines.push("");
+    lines.push("When no prompt is given, Aether starts an interactive TUI.");
+    return lines.join("\n");
+}
 function isMainModule() {
-    // Robust across tsx/Node and Windows path formatting.
+    // Robust across tsx/Node and Windows path formatting. The compiled bin is
+    // dist/index.js; tsx may also hand us src/index.ts directly.
     const self = import.meta.url.replace(/\/$/g, "");
     const argv1 = "file://" + path.resolve(process.argv[1] ?? "");
     if (self === argv1)
         return true;
-    // Also match when invoked via `tsx` where argv may be a .ts source file.
+    const binNames = ["dist/index.js", "src/index.ts"];
+    if (binNames.includes(path.basename(process.argv[1] ?? "")))
+        return true;
+    // Also match when invoked via tsx where argv may be a .ts source file.
     try {
         const selfPath = new URL(self).pathname;
         const argvPath = path.resolve(process.argv[1] ?? "");
@@ -189,9 +225,10 @@ function isMainModule() {
     return false;
 }
 if (isMainModule()) {
-    // Parse CLI flags: --plan and --yolo set the agent mode and are stripped
-    // from the prompt args.
+    // Parse CLI flags: --plan, --yolo, --no-stream, --version and --help are
+    // consumed here and stripped from the prompt args.
     let modeFlag = null;
+    let noStream = false;
     const promptArgs = [];
     for (const arg of process.argv.slice(2)) {
         if (arg === "--plan") {
@@ -200,6 +237,17 @@ if (isMainModule()) {
         else if (arg === "--yolo") {
             modeFlag = "yolo";
         }
+        else if (arg === "--no-stream") {
+            noStream = true;
+        }
+        else if (arg === "--version" || arg === "-v") {
+            process.stdout.write("aether-ai " + VERSION + "\n");
+            process.exit(0);
+        }
+        else if (arg === "--help" || arg === "-h") {
+            process.stdout.write(getHelpText() + "\n");
+            process.exit(0);
+        }
         else {
             promptArgs.push(arg);
         }

package/package.json

@@ -1,34 +1,44 @@
-{
-  "name": "@hemansubedi/aether-ai",
-  "version": "1.0.0",
-  "description": "The Aether CLI: the free, unlimited, multi-provider LLM CLI - install like KiloCode, run like Claude Code.",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "aether-ai": "dist/index.js",
-    "aether-ai-server": "dist/server.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "start": "node dist/index.js",
-    "dev": "tsx src/index.ts"
-  },
-  "engines": { "node": ">=20" },
-  "keywords": ["llm", "cli", "ai", "router", "ollama", "openrouter", "free"],
-  "author": "Heman Subedi <hemansubedi66@gmail.com>",
-  "license": "MIT",
-  "homepage": "https://github.com/hemansubedi10/aether",
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hemansubedi10/aether.git"
-  },
-  "dependencies": {},
-  "devDependencies": {
-    "typescript": "^7.0.0",
-    "tsx": "^4.0.0",
-    "@types/node": "^22.0.0"
-  },
-  "publishConfig": {
-    "access": "public"
-  }
-}
+{
+  "name": "@hemansubedi/aether-ai",
+  "version": "1.0.1",
+  "description": "The Aether CLI: the free, unlimited, multi-provider LLM CLI - install like KiloCode, run like Claude Code.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "aether-ai": "dist/index.js",
+    "aether-ai-server": "dist/server.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsx src/index.ts"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "keywords": [
+    "llm",
+    "cli",
+    "ai",
+    "router",
+    "ollama",
+    "openrouter",
+    "free"
+  ],
+  "author": "Heman Subedi <hemansubedi66@gmail.com>",
+  "license": "MIT",
+  "homepage": "https://github.com/hemansubedi10/aether",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hemansubedi10/aether.git"
+  },
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "^7.0.0",
+    "tsx": "^4.0.0",
+    "@types/node": "^22.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -178,40 +178,86 @@ import { GitTool } from "./git.js";
 import { Checkpoint } from "./checkpoint.js";
 import { Skills } from "./skills.js";
 
-// CLI entrypoint
-function isMainModule(): boolean {
-  // Robust across tsx/Node and Windows path formatting.
-  const self = import.meta.url.replace(/\/$/g, "");
-  const argv1 = "file://" + path.resolve(process.argv[1] ?? "");
-  if (self === argv1) return true;
-  // Also match when invoked via `tsx` where argv may be a .ts source file.
-  try {
-    const selfPath = new URL(self).pathname;
-    const argvPath = path.resolve(process.argv[1] ?? "");
-    const norm = (p: string) => p.toLowerCase().replace(/\\/g, "/").replace(/^\//, "");
-    if (norm(selfPath) === norm(argvPath)) return true;
-  } catch {
-    // ignore
-  }
-  return false;
-}
-
-if (isMainModule()) {
-  // Parse CLI flags: --plan and --yolo set the agent mode and are stripped
-  // from the prompt args.
-  let modeFlag: string | null = null;
-  const promptArgs: string[] = [];
-  for (const arg of process.argv.slice(2)) {
-    if (arg === "--plan") {
-      modeFlag = "plan";
-    } else if (arg === "--yolo") {
-      modeFlag = "yolo";
-    } else {
-      promptArgs.push(arg);
-    }
-  }
-  const prompt = promptArgs.join(" ").trim();
-
+// CLI entrypoint
+const VERSION = "1.0.0";
+
+function getHelpText() {
+  const lines = [];
+  lines.push("Aether - the free, unlimited, multi-provider LLM CLI");
+  lines.push("");
+  lines.push("Usage: aether-ai [options] [prompt]");
+  lines.push("");
+  lines.push("Options:");
+  lines.push("  -h, --help        Show this help text and exit");
+  lines.push("  -v, --version     Print the version and exit");
+  lines.push("  --plan            Run in plan mode (step-by-step approval)");
+  lines.push("  --yolo            Run in yolo mode (autonomous execution)");
+  lines.push("  --no-stream       Disable streaming output in one-shot mode");
+  lines.push("");
+  lines.push("Commands (prefix a prompt with /):");
+  lines.push("  /help             Show all available commands");
+  lines.push("  /model <name>     Switch the active model");
+  lines.push("  /provider <name>  Switch the active provider");
+  lines.push("  /models           List all available models across providers");
+  lines.push("  /providers        Show provider health status");
+  lines.push("  /combo ...        Manage named provider/model combos");
+  lines.push("  /session ...      Manage sessions");
+  lines.push("  /arena            Enter arena mode (compare models)");
+  lines.push("  /cost             Show token usage and estimated cost summary");
+  lines.push("  /stats            Show session stats, cost summary, and provider health");
+  lines.push("  /skills           List available custom skills");
+  lines.push("  /connect ...      Connect an API key for a provider");
+  lines.push("  /exit             Exit the TUI");
+  lines.push("");
+  lines.push("When no prompt is given, Aether starts an interactive TUI.");
+  return lines.join("\n");
+}
+
+function isMainModule() {
+  // Robust across tsx/Node and Windows path formatting. The compiled bin is
+  // dist/index.js; tsx may also hand us src/index.ts directly.
+  const self = import.meta.url.replace(/\/$/g, "");
+  const argv1 = "file://" + path.resolve(process.argv[1] ?? "");
+  if (self === argv1) return true;
+  const binNames = ["dist/index.js", "src/index.ts"];
+  if (binNames.includes(path.basename(process.argv[1] ?? ""))) return true;
+  // Also match when invoked via tsx where argv may be a .ts source file.
+  try {
+    const selfPath = new URL(self).pathname;
+    const argvPath = path.resolve(process.argv[1] ?? "");
+    const norm = (p: string) => p.toLowerCase().replace(/\\/g, "/").replace(/^\//, "");
+    if (norm(selfPath) === norm(argvPath)) return true;
+  } catch {
+    // ignore
+  }
+  return false;
+}
+
+if (isMainModule()) {
+  // Parse CLI flags: --plan, --yolo, --no-stream, --version and --help are
+  // consumed here and stripped from the prompt args.
+  let modeFlag = null;
+  let noStream = false;
+  const promptArgs = [];
+  for (const arg of process.argv.slice(2)) {
+    if (arg === "--plan") {
+      modeFlag = "plan";
+    } else if (arg === "--yolo") {
+      modeFlag = "yolo";
+    } else if (arg === "--no-stream") {
+      noStream = true;
+    } else if (arg === "--version" || arg === "-v") {
+      process.stdout.write("aether-ai " + VERSION + "\n");
+      process.exit(0);
+    } else if (arg === "--help" || arg === "-h") {
+      process.stdout.write(getHelpText() + "\n");
+      process.exit(0);
+    } else {
+      promptArgs.push(arg);
+    }
+  }
+  const prompt = promptArgs.join(" ").trim();
+
   if (!prompt) {
     // Interactive TUI mode.
     const { tui } = createTUIContext();