@ringko-ai/rkh 0.2.1-rc → 0.3.0

package/README.md

@@ -1,12 +1,18 @@
-# RingKo CLI
+# RingKo Harness
 
-`@ringko-ai/rkh` is the RingKo agent CLI, distributed as a globally installed npm
-package. The `ringko` executable is a Bun bundle, so Node.js 24+ **and**
-[Bun](https://bun.sh/) 1.2+ must be on `PATH` — Bun is not optional.
+RingKo is a provider-neutral agent harness. The `ringko` command offers two
+interface styles: an interactive terminal UI (plain `ringko`, the default) and a
+browser UI (`ringko serve`, which prints the URL to open). Both run the same tool
+registry, the same approval gate and the same event-sourced session log.
+
+`@ringko-ai/rkh` installs that command globally. The executable is a Bun bundle, so
+Node.js 24+ **and** [Bun](https://bun.sh/) 1.2+ must be on `PATH` — Bun is not
+optional.
 
 ```sh
 npm install -g @ringko-ai/rkh
-ringko tui
+ringko          # terminal interface (default)
+ringko serve    # local backend + browser interface, prints its URL
 ```
 
 `ringko help` lists every command. Without a global install, `npx @ringko-ai/rkh tui`

package/bin/ringko.mjs

@@ -127854,7 +127854,7 @@ function resumeHint(sessionId, workspace, entry, windows = process.platform ===
   const source = entry && /\.tsx?$/.test(entry) && !entry.includes("$bunfs") ? `bun ${quote(entry, windows)}` : cliCommand(entry);
   return `
 Resume this session with:
-${source} tui --session ${quote(sessionId, windows)} --workspace ${quote(workspace, windows)}`;
+${source} --session ${quote(sessionId, windows)} --workspace ${quote(workspace, windows)}`;
 }
 
 // packages/tui/src/cli.ts
@@ -127952,20 +127952,20 @@ init_src3();
 // packages/tui/src/provider.ts
 init_loader();
 // packages/tui/package.json
-var version2 = "0.2.1-rc";
+var version2 = "0.3.0";
 
 // packages/tui/src/cli.ts
 var VERSION8 = version2;
-var USAGE = `${cliCommand()} - RingKo agent harness CLI
+var USAGE = `${cliCommand()} - RingKo agent harness
 
 Usage:
+  ${cliCommand()}                 Interactive terminal UI (default)
   ${cliCommand()} <command> [options]
 
 Commands:
   run <prompt>         Run the agent
   loop <prompt>        Repeat a prompt until --completion-promise or --max-iterations
-  tui                  Interactive terminal UI
-  serve                Start the shared HTTP backend (TUI starts one automatically)
+  serve                Start the local backend and browser UI
   service start|status|stop  Manage the shared backend of this workspace
   tools                List the registered tools
   skills               List installed skills (~/.ringko/skills, ~/.agents/skills)
@@ -127989,11 +127989,11 @@ Commands:
   help                 Show this help
 
 Options:
-  --config <path>      Config file (default: ~/.ringko/config)
+  --config <path>      Explicit config file (default: ~/.ringko/settings.local.json + provider.json)
   --provider <name>    Override the configured provider (default: echo)
   --model <id>         Override the configured model id
   --resume, -c         Continue the most recent session
-  -s, --session [id]   Continue a session; omit the id for a session picker (TUI)
+  -s, --session [id]   Continue a session; omit the id for the session picker
   --workspace <dir>    Workspace root for file tools (default: current directory)
   --server <url>       Connect to an existing local backend (or RINGKO_SERVER)
   --port <number>      (serve) HTTP port (default: 8787)
@@ -128010,8 +128010,11 @@ function denyApprovals(io) {
     return false;
   };
 }
+var DASH_COMMANDS = new Set(["--help", "-h", "--version", "-v"]);
 function parseArgs(argv) {
-  const [command, ...rest] = argv;
+  const [first, ...rest] = argv;
+  const command = first !== undefined && (!first.startsWith("-") || DASH_COMMANDS.has(first)) ? first : undefined;
+  const args = command === undefined ? argv : rest;
   const positionals = [];
   let config;
   let provider;
@@ -128023,14 +128026,14 @@ function parseArgs(argv) {
   let server;
   let port;
   let shared;
-  for (let i = 0;i < rest.length; i += 1) {
-    const arg = rest[i];
+  for (let i = 0;i < args.length; i += 1) {
+    const arg = args[i];
     if (arg === "--shared") {
       shared = true;
       continue;
     }
     if (arg === "--server" || arg === "--port") {
-      const value = rest[++i];
+      const value = args[++i];
       if (!value || value.startsWith("--"))
         throw new TypeError(`Missing value for ${arg}.`);
       if (arg === "--server")
@@ -128047,7 +128050,7 @@ function parseArgs(argv) {
       continue;
     }
     if (arg === "-s" || arg === "--session") {
-      const value = rest[i + 1];
+      const value = args[i + 1];
       if (value !== undefined && !value.startsWith("-")) {
         session = value;
         i += 1;
@@ -128057,7 +128060,7 @@ function parseArgs(argv) {
       continue;
     }
     if (arg === "--config" || arg === "--provider" || arg === "--model" || arg === "--workspace") {
-      const value = rest[i + 1];
+      const value = args[i + 1];
       if (value === undefined)
         throw new TypeError(`Missing value for ${arg}.`);
       if (arg === "--config")
@@ -128214,7 +128217,7 @@ async function loopCommand(parsed, io) {
 }
 async function tuiCommand(parsed, io) {
   if (!process.stdout.isTTY) {
-    io.err(`${cliCommand()} tui requires an interactive terminal.`);
+    io.err(`${cliCommand()} requires an interactive terminal; use ${cliCommand()} serve for the browser UI.`);
     return 1;
   }
   const config = readConfig(parsed, io);
@@ -128619,6 +128622,7 @@ async function runCli(argv, io) {
   }
   switch (parsed.command) {
     case undefined:
+      return tuiCommand(parsed, io);
     case "help":
     case "--help":
     case "-h":
@@ -128656,8 +128660,6 @@ async function runCli(argv, io) {
       return modelsCommand(parsed, io);
     case "auth":
       return authCommand(parsed, io);
-    case "tui":
-      return tuiCommand(parsed, io);
     case "serve":
       return serveCommand(parsed, io);
     case "service": {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@ringko-ai/rkh",
-  "version": "0.2.1-rc",
-  "description": "RingKo interactive agent CLI",
+  "version": "0.3.0",
+  "description": "RingKo agent harness: terminal and web interfaces",
   "type": "module",
   "license": "Apache-2.0",
   "bin": {