@hanamorilabs/tab 0.1.4 → 0.1.5

package/README.md

@@ -45,8 +45,8 @@ kill switch stay on flocktab.com. It is one small Rust binary. `tab up` asks
 for the keys once (typed without echo, saved owner-only to
 `~/.flocktab/proxy.env`), fetches `flocktab-proxy` for this machine into
 `~/.flocktab/bin`, and starts it in the background (log: `~/.flocktab/proxy.log`).
-`tab down` stops it; `tab update` fetches the newest proxy and restarts;
-`tab claude` starts it when it is down. No Docker, no Rust, no checkout: the
+`tab down` stops it; `tab update` installs the newest tab, which brings the
+newest proxy, and restarts it; `tab claude` starts it when it is down. No Docker, no Rust, no checkout: the
 binary comes with `tab` as the `@hanamorilabs/flocktab-proxy-<platform>`
 package for your machine. Then
 `tab login`, pick **2 Self-hosted**: the proxy says which console it settles
@@ -64,7 +64,7 @@ tab alias remove <name>...  undo that; `tab alias list` shows them
 tab status           flock, folder Agent, proxy health, provider key state
 tab version          tab and proxy versions
 tab up | down        self-hosted: start or stop the local proxy
-tab update           self-hosted: newest proxy (npm i -g @hanamorilabs/tab@latest)
+tab update           the newest tab and proxy from npm; restarts a running local proxy
 tab logout           forget the session and keys on this machine
 tab help             this list
 ```
@@ -77,19 +77,19 @@ this folder's Agent. Every read takes `--json`.
 
 ```
 tab list                                 every Agent: state, spent of cap, window, project
-tab close crawler        tab open crawler   the kill switch (402 tab_closed on the next call)
-tab cap crawler 25 --window week         cap in dollars, and the window
-tab rename crawler "Nightly crawler"     the slug stays
-tab policy crawler --velocity 60 --models gpt-5,claude-sonnet-5 --allow email.send
-tab project crawler Foley --create       attribute to a project (--repo owner/name; none clears)
+tab close my-project        tab open my-project   the kill switch (402 tab_closed on the next call)
+tab cap my-project 25 --window week         cap in dollars, and the window
+tab rename my-project "My project (nightly)"     the slug stays
+tab policy my-project --velocity 60 --models gpt-5,claude-sonnet-5 --allow email.send
+tab project my-project Foley --create       attribute to a project (--repo owner/name; none clears)
 tab projects add Foley                   projects
-tab key rotate crawler [--show]          new key, kept on this machine; --show prints it once
-tab archive crawler                      closes for good, leaves the bill (asks first; -y skips)
-tab ledger [crawler] --limit 20 --blocked   one row per call: settled of held, status, reason
+tab key rotate my-project [--show]          new key, kept on this machine; --show prints it once
+tab archive my-project                      closes for good, leaves the bill (asks first; -y skips)
+tab ledger [my-project] --limit 20 --blocked   one row per call: settled of held, status, reason
 tab spend [agent|project|day] --since 7d    meter and outside spend, the console's numbers
 tab outside                              connections, per-project outside spend, unattributed
 tab live --watch 4                       who is working now, refreshed every 4 seconds
-tab web [crawler]                        the Agent's console page in the browser
+tab web [my-project]                        the Agent's console page in the browser
 ```
 
 ## Aliases: plain `codex` on the tab

package/dist/cli.js

@@ -11,7 +11,8 @@
  *   tab alias remove codex undo that; `tab alias list` shows them
  *   tab status             which flock, which Agent here, is the proxy up
  *   tab version            tab and proxy versions
- *   tab up | down | update self-hosted: start, stop, or fetch the newest proxy
+ *   tab up | down          self-hosted: start or stop the local proxy
+ *   tab update             the newest tab and proxy from npm
  *   tab logout             forget the session and keys
  *
  * Login is per machine. The Agent is per folder: the first `tab claude` in
@@ -73,7 +74,7 @@ function usage() {
         cmd("... --json", "every read command as JSON, for scripts and agents"),
         cmd("up", "self-hosted: start the local proxy (fetches it the first time)"),
         cmd("down", "self-hosted: stop the local proxy"),
-        cmd("update", "self-hosted: fetch the newest proxy and restart it"),
+        cmd("update", "the newest tab (and proxy) from npm; restarts a running local proxy"),
         cmd("logout", "forget the session and keys"),
     ].map(([k, v]) => [cyan(k), v])));
     say(`
@@ -621,6 +622,48 @@ async function collectProviderKeys() {
     ok(`Saved to ${dim(file)} ${dim("(owner-only)")}`);
     return true;
 }
+/**
+ * `tab update`: the newest tab from npm, which carries the newest proxy as
+ * its platform package. A self-hosted proxy that was running is restarted
+ * on the new binary; a hosted machine just gets the new tab.
+ */
+async function update() {
+    const config = await loadConfig();
+    const wasUp = config?.mode === "self-hosted" && (await proxyHealth(config.proxyUrl)).ok;
+    say(dim(`tab ${TAB_VERSION} now; asking npm for the newest.`));
+    const code = await new Promise((resolve) => {
+        const child = spawn(process.platform === "win32" ? "npm.cmd" : "npm", ["i", "-g", "@hanamorilabs/tab@latest"], {
+            stdio: ["ignore", "ignore", "inherit"],
+            shell: process.platform === "win32",
+        });
+        child.on("error", () => resolve(1));
+        child.on("close", (c) => resolve(c ?? 1));
+    });
+    if (code !== 0) {
+        fail(`npm could not update tab. Try: ${bold("npm i -g @hanamorilabs/tab@latest")}`);
+        return 1;
+    }
+    // The version now on PATH is the new install's, not this process's.
+    const installed = await new Promise((resolve) => {
+        const child = spawn(process.platform === "win32" ? "tab.cmd" : "tab", ["version"], { shell: process.platform === "win32" });
+        let text = "";
+        child.stdout?.on("data", (d) => (text += d.toString()));
+        child.stderr?.on("data", (d) => (text += d.toString()));
+        child.on("close", () => resolve(text.trim()));
+        child.on("error", () => resolve(""));
+    });
+    ok(installed ? `Updated.
+${installed}` : "Updated.");
+    if (!wasUp) {
+        if (!packagedBinPath() && config?.mode === "self-hosted") {
+            const fetched = await downloadProxy((t) => say(dim(t)));
+            (fetched.ok ? ok : fail)(fetched.ok ? `Fetched flocktab-proxy ${PROXY_VERSION}.` : fetched.message);
+        }
+        return 0;
+    }
+    await stopProxy();
+    return (await bringUp(config.proxyUrl)) ? 0 : 1;
+}
 async function selfHosted(action) {
     const config = await loadConfig();
     const proxyUrl = config?.mode === "self-hosted" ? config.proxyUrl : LOCAL_PROXY;
@@ -629,30 +672,6 @@ async function selfHosted(action) {
         (stopped ? ok : warn)(stopped ? "Proxy stopped." : "Proxy was not running.");
         return 0;
     }
-    if (action === "update") {
-        await stopProxy();
-        if (packagedBinPath()) {
-            // The binary is part of the npm install; the newest one comes with the newest tab.
-            say(`The proxy ships with tab. Updating tab updates it: ${bold("npm i -g @hanamorilabs/tab@latest")}`);
-            const code = await new Promise((resolve) => {
-                const child = spawn(process.platform === "win32" ? "npm.cmd" : "npm", ["i", "-g", "@hanamorilabs/tab@latest"], { stdio: "inherit" });
-                child.on("error", () => resolve(1));
-                child.on("close", (c) => resolve(c ?? 1));
-            });
-            if (code !== 0) {
-                fail("npm could not update tab.");
-                return 1;
-            }
-        }
-        else {
-            const fetched = await downloadProxy((t) => say(dim(t)));
-            if (!fetched.ok) {
-                fail(fetched.message);
-                return 1;
-            }
-            ok(`Fetched flocktab-proxy ${PROXY_VERSION}.`);
-        }
-    }
     if (!(await hasProxyEnv())) {
         const written = await collectProviderKeys();
         if (!written)
@@ -759,7 +778,7 @@ async function main(argv) {
         case "down":
             return selfHosted("down");
         case "update":
-            return selfHosted("update");
+            return update();
         default:
             return runAgent(command, rest);
     }

package/dist/version.js

@@ -1,2 +1,2 @@
 /** Written by scripts/write-version.mjs from package.json at build; `tab version` prints it. */
-export const TAB_VERSION = "0.1.4";
+export const TAB_VERSION = "0.1.5";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanamorilabs/tab",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Run any AI agent on a FlockTab tab: tab claude, tab codex, tab <command>.",
   "license": "MIT",
   "type": "module",