@hanamorilabs/tab 0.1.2 → 0.1.3

package/README.md

@@ -59,8 +59,8 @@ Codex shows `FlockTab - Self-hosted` as its provider.
 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 alias <name>...  make plain `codex` run `tab codex` (shims in ~/.flocktab/bin)
-tab unalias <name>   remove such a shim
+tab alias setup <name>...   make plain `codex` run `tab codex` (shims in ~/.flocktab/bin)
+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
@@ -72,16 +72,18 @@ tab help             this list
 ## Aliases: plain `codex` on the tab
 
 ```
-tab alias codex claude
+tab alias setup codex claude
 export PATH="$HOME/.flocktab/bin:$PATH"   # once, in your shell rc
 codex                                     # now runs: tab codex
+tab alias remove codex                    # back to the plain codex
 ```
 
-`tab alias` writes a shim named after the command into `~/.flocktab/bin`
-(`codex.cmd` on Windows). With that folder first on `PATH`, the plain
-command runs on the tab. When `tab` spawns the real agent it removes its
-own shim folder from the child's `PATH`, so nothing loops. `tab alias` with
-no name lists them; `tab unalias codex` removes one. Prefer a shell alias?
+`tab alias setup` writes a shim named after the command into
+`~/.flocktab/bin` (`codex.cmd` on Windows). With that folder first on
+`PATH`, the plain command runs on the tab. When `tab` spawns the real agent
+it removes its own shim folder from the child's `PATH`, so nothing loops.
+`tab alias list` shows them; `tab alias remove <name>` deletes the shim, and
+the plain command is the real one again. Prefer a shell alias?
 `alias codex='tab codex'` in your rc does the same for that shell only.
 
 ## Secrets and colour

package/dist/cli.js

@@ -7,7 +7,8 @@
  *   tab codex  [...args]   Codex on the tab
  *   tab <cmd>  [...args]   anything else, both APIs pointed at the tab
  *   tab use                pick (or change) the Agent this folder runs as
- *   tab alias codex ...    make plain `codex` run `tab codex` (shims in ~/.flocktab/bin)
+ *   tab alias setup codex  make plain `codex` run `tab codex` (shims in ~/.flocktab/bin)
+ *   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
@@ -50,8 +51,8 @@ function usage() {
         cmd(others.join(" | tab "), "the same, for those agents"),
         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("alias <name>...", "make plain `codex` run `tab codex` (shims in ~/.flocktab/bin)"),
-        cmd("unalias <name>", "remove such a shim"),
+        cmd("alias setup <name>...", "make plain `codex` run `tab codex` (shims in ~/.flocktab/bin)"),
+        cmd("alias remove <name>...", "undo that; `tab alias list` shows them"),
         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)"),
@@ -521,7 +522,20 @@ async function runAgent(name, args) {
  * `tab alias codex claude`: shims so the plain commands run on the tab.
  * `tab alias` alone lists them; `tab unalias codex` removes one.
  */
-async function alias(names, remove = false) {
+async function alias(args, removeFlag = false) {
+    // `tab alias setup codex`, `tab alias remove codex`, `tab alias list`;
+    // the bare `tab alias codex` and `tab unalias codex` mean the same.
+    const [first, ...rest] = args;
+    let names = args;
+    let remove = removeFlag;
+    if (first === "setup" || first === "add")
+        names = rest;
+    else if (first === "remove" || first === "rm") {
+        names = rest;
+        remove = true;
+    }
+    else if (first === "list" || first === "ls")
+        names = [];
     if (names.length === 0 && !remove) {
         const existing = await listAliases();
         if (existing.length === 0)
@@ -531,7 +545,7 @@ async function alias(names, remove = false) {
         return pathHint();
     }
     if (names.length === 0) {
-        fail("tab unalias needs a name.");
+        fail("tab alias remove needs a name, e.g. tab alias remove codex");
         return 2;
     }
     for (const name of names) {

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.2";
+export const TAB_VERSION = "0.1.3";

package/package.json

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