@hanamorilabs/tab 0.1.0 → 0.1.1

package/README.md

@@ -1,6 +1,6 @@
 # tab
 
-Run any AI agent on a FlockTab tab.
+Run any AI agent on a FlockTab tab. Needs Node 22 or newer; nothing else.
 
 ```
 npm i -g @hanamorilabs/tab
@@ -46,11 +46,27 @@ 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 checkout. Then
+`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
 through, so the device code lands on flocktab.com. No unlock in this mode;
 Codex shows `FlockTab - Self-hosted` as its provider.
 
+## Commands
+
+```
+tab login            approve this machine in the console, once
+tab <agent> [args]   claude, codex, grok, kimi, gemini, or any command, on the tab
+tab use              pick or change the Agent this folder runs as (.flocktab)
+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 logout           forget the session and keys on this machine
+tab help             this list
+```
+
 ## Secrets and colour
 
 The unlock and provider keys are typed with echo off (raw mode); the unlock is checked against the proxy before saving; a wrong unlock is refused, and `tab status` says `unlock ok` or `unlock is WRONG`. The check is `GET /v1/whoami` with the unlock, which decrypts the envelope in memory and answers `ok`/`wrong`, never the key. Output is coloured on a terminal; `NO_COLOR` turns it off, `FORCE_COLOR` turns it on for pipes.

package/dist/cli.js

@@ -8,6 +8,7 @@
  *   tab <cmd>  [...args]   anything else, both APIs pointed at the tab
  *   tab use                pick (or change) the Agent this folder runs as
  *   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 logout             forget the session and keys
  *
@@ -28,8 +29,9 @@ import { consoleUrlFor, DeviceLoginError, startDeviceLogin, waitForApproval } fr
 import { clearConfig, configDir, configPath, HOSTED_PROXY, isLocalProxy, loadConfig, LOCAL_PROXY, normalizeProxyUrl, presentedKey, saveConfig, } from "./config.js";
 import { reportFolder } from "./folder.js";
 import { agentNameFor, projectRoot, readProject, writeProject } from "./project.js";
-import { downloadProxy, hasProxyEnv, packagedBinPath, proxyBinPath, proxyEnvPath, proxyLogPath, PROXY_VERSION, startProxy, stopProxy, tailProxyLog, writeProxyEnv, } from "./proxy-bin.js";
+import { downloadProxy, hasProxyEnv, packagedBinPath, proxyBinPath, proxyEnvPath, proxyInstalled, proxyLogPath, PROXY_VERSION, startProxy, stopProxy, tailProxyLog, writeProxyEnv, } from "./proxy-bin.js";
 import { proxyHealth, waitHealthy } from "./selfhost.js";
+import { TAB_VERSION } from "./version.js";
 const say = (text) => console.error(text);
 const ok = (text) => say(line("ok", text));
 const warn = (text) => say(line("warn", text));
@@ -47,6 +49,7 @@ function usage() {
         cmd("<command> [args]", "any other agent, both APIs pointed at the tab"),
         cmd("use", "pick or change the Agent this folder runs as (.flocktab)"),
         cmd("status", "which flock, which Agent here, is the proxy up"),
+        cmd("version", "tab and proxy versions"),
         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"),
@@ -423,6 +426,15 @@ async function resolveAgent(config, opts = {}) {
     ok(`This folder runs as ${bold(issued.agent.name)} ${dim(`(${file})`)}`);
     return login;
 }
+/** `tab version`: this CLI, and the proxy it would run (packaged, downloaded, or neither). */
+async function version() {
+    const packaged = packagedBinPath();
+    const bin = proxyBinPath();
+    const installed = await proxyInstalled();
+    const where = packaged ? `packaged, ${packaged}` : installed ? `downloaded, ${bin}` : "not installed; tab up fetches it";
+    say(rows([["tab", TAB_VERSION], ["proxy", `${PROXY_VERSION}  ${dim(`(${where})`)}`]], 0));
+    return 0;
+}
 async function status() {
     const config = await loadConfig();
     if (!config) {
@@ -488,6 +500,8 @@ async function runAgent(name, args) {
         child.on("error", (err) => {
             if (err.code === "ENOENT") {
                 fail(`${spec.label} is not installed (${spec.command} not on PATH). ${dim(spec.install)}`);
+                if (!knownClients().includes(name))
+                    say(dim(`Not a tab command either; see ${bold("tab help")}.`));
                 resolve(127);
                 return;
             }
@@ -591,6 +605,10 @@ async function main(argv) {
             return 0;
         case "use":
             return use();
+        case "version":
+        case "--version":
+        case "-v":
+            return version();
         case "status":
             return status();
         case "up":

package/dist/version.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hanamorilabs/tab",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Run any AI agent on a FlockTab tab: tab claude, tab codex, tab <command>.",
   "license": "MIT",
   "type": "module",
@@ -15,7 +15,7 @@
     "node": ">=22"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.build.json && chmod +x dist/cli.js",
+    "build": "node scripts/write-version.mjs && tsc -p tsconfig.build.json && chmod +x dist/cli.js",
     "dev": "tsx src/cli.ts",
     "test": "vitest run",
     "typecheck": "tsc --noEmit",