vibegroup 0.1.8 → 0.1.10

package/README.md

@@ -12,21 +12,18 @@ When you and your teammates are each heads-down in your own repo on your own mac
 ## Install
 
 ```bash
-npx vibegroup install     # registers the vibegroup plugin in Claude Code
+npm i -g vibegroup     # installs the `vibegroup` command (the Claude Code plugin ships inside it)
+vibegroup init         # one-time: registers the plugin, enables the channel, signs you in
 ```
 
-Or install the CLI globally:
-
-```bash
-npm i -g vibegroup
-```
+That's the whole setup — `vibegroup init` installs the plugin for you. You need the global install because the everyday commands (`vibegroup claude`, `vibegroup who`) are run from your shell. (`npx vibegroup install` only registers the plugin and leaves no command behind, so don't rely on it.)
 
 ## Quickstart
 
 ```bash
-vibegroup init                          # one-time: install the plugin, enable the channel, sign in
 vibegroup team create acme --name Acme  # create a team (or get invited to one)
 vibegroup claude --team acme            # launch Claude Code wired to your team's room
+vibegroup who --team acme               # see who's in the room (people + their sessions)
 ```
 
 Inside the session, your agent can reach teammates' agents:
@@ -44,8 +41,8 @@ Inside the session, your agent can reach teammates' agents:
 ## Commands
 
 ```
-vibegroup install                        Register the plugin in Claude Code (also: npx vibegroup install)
-vibegroup init [email]                   One-time setup: plugin + channel + sign-in
+vibegroup init [email]                   One-time setup: plugin + channel + sign-in (start here)
+vibegroup install                        Re-register just the plugin (init already does this)
 vibegroup login [email]                  Sign in / sign up
 vibegroup logout                         Clear the cached session
 vibegroup status                         Show your auth status

package/dist/cli.js

@@ -70,7 +70,7 @@ var package_default;
 var init_package = __esm(() => {
   package_default = {
     name: "vibegroup",
-    version: "0.1.8",
+    version: "0.1.10",
     description: "Talk to your teammates' Claude Code agents — agent-to-agent collaboration for Claude Code over a shared channel.",
     type: "module",
     bin: {
@@ -134,6 +134,209 @@ var init_package = __esm(() => {
   };
 });
 
+// src/ui/runner.ts
+import { render } from "ink";
+function runInk(make) {
+  return new Promise((resolve) => {
+    let done = false;
+    let instance;
+    const finish = (code) => {
+      if (done)
+        return;
+      done = true;
+      instance?.unmount();
+      resolve(code);
+    };
+    instance = render(make(finish));
+    instance.waitUntilExit().then(() => finish(130));
+  });
+}
+var init_runner = () => {};
+
+// src/ui/theme.ts
+var color;
+var init_theme = __esm(() => {
+  color = {
+    brand: "magenta",
+    accent: "cyan",
+    ok: "green",
+    warn: "yellow",
+    err: "red",
+    dim: "gray"
+  };
+});
+
+// src/ui/Home.tsx
+import { useState } from "react";
+import { Box, Text, useInput } from "ink";
+import { jsx, jsxs } from "react/jsx-runtime";
+function Home({
+  identity,
+  version,
+  items = HOME_ITEMS,
+  onSelect
+}) {
+  const [i, setI] = useState(0);
+  useInput((input, key) => {
+    if (input === "q" || key.escape || key.ctrl && input === "c")
+      return onSelect(null);
+    if (key.upArrow)
+      setI((s) => (s - 1 + items.length) % items.length);
+    if (key.downArrow)
+      setI((s) => (s + 1) % items.length);
+    if (key.return)
+      return onSelect(items[i].cmd);
+  });
+  const sel = items[i];
+  return /* @__PURE__ */ jsxs(Box, {
+    flexDirection: "column",
+    paddingX: 1,
+    paddingY: 1,
+    gap: 1,
+    children: [
+      /* @__PURE__ */ jsxs(Box, {
+        borderStyle: "round",
+        borderColor: color.brand,
+        paddingX: 1,
+        flexDirection: "column",
+        children: [
+          /* @__PURE__ */ jsxs(Text, {
+            children: [
+              /* @__PURE__ */ jsx(Text, {
+                color: color.brand,
+                bold: true,
+                children: "vibegroup"
+              }),
+              /* @__PURE__ */ jsx(Text, {
+                dimColor: true,
+                children: "  talk to your teammates' Claude Code agents"
+              })
+            ]
+          }),
+          /* @__PURE__ */ jsxs(Text, {
+            dimColor: true,
+            children: [
+              identity ? `signed in as ${identity}` : "not signed in — start with init or login",
+              "   ·   ",
+              "v",
+              version
+            ]
+          })
+        ]
+      }),
+      /* @__PURE__ */ jsx(Box, {
+        flexDirection: "column",
+        children: items.map((it, idx) => {
+          const active = idx === i;
+          return /* @__PURE__ */ jsxs(Box, {
+            children: [
+              /* @__PURE__ */ jsx(Text, {
+                color: active ? color.accent : undefined,
+                children: active ? "❯ " : "  "
+              }),
+              /* @__PURE__ */ jsx(Box, {
+                width: 14,
+                children: /* @__PURE__ */ jsx(Text, {
+                  bold: active,
+                  color: active ? color.accent : undefined,
+                  children: it.label
+                })
+              }),
+              /* @__PURE__ */ jsx(Text, {
+                dimColor: true,
+                children: it.desc
+              })
+            ]
+          }, it.cmd);
+        })
+      }),
+      /* @__PURE__ */ jsx(Box, {
+        borderStyle: "round",
+        borderColor: color.dim,
+        paddingX: 1,
+        children: /* @__PURE__ */ jsxs(Text, {
+          children: [
+            /* @__PURE__ */ jsxs(Text, {
+              dimColor: true,
+              children: [
+                sel.runnable ? "runs" : "type",
+                ": "
+              ]
+            }),
+            /* @__PURE__ */ jsx(Text, {
+              color: color.accent,
+              children: sel.usage
+            })
+          ]
+        })
+      }),
+      /* @__PURE__ */ jsxs(Text, {
+        dimColor: true,
+        children: [
+          "↑↓ navigate · ⏎ ",
+          sel.runnable ? "run" : "show command",
+          " · q quit"
+        ]
+      })
+    ]
+  });
+}
+var HOME_ITEMS;
+var init_Home = __esm(() => {
+  init_theme();
+  HOME_ITEMS = [
+    { cmd: "init", label: "init", desc: "One-time setup: install plugin, enable channel, sign in", usage: "vibegroup init [email]", runnable: true },
+    { cmd: "who", label: "who", desc: "Live view of who's in a room (people + sessions)", usage: "vibegroup who --team <slug> [--room <name>]", runnable: false },
+    { cmd: "claude", label: "claude", desc: "Launch Claude Code wired to a room", usage: "vibegroup claude --team <slug> [--room <name>] [--session <label>]", runnable: false },
+    { cmd: "status", label: "status", desc: "Your auth + connection status", usage: "vibegroup status", runnable: true },
+    { cmd: "team", label: "team create", desc: "Create a team (a WorkOS org + a general room)", usage: "vibegroup team create <slug> [--name <name>]", runnable: false },
+    { cmd: "room", label: "room create", desc: "Add a room to a team", usage: "vibegroup room create <name> --team <slug>", runnable: false },
+    { cmd: "rooms", label: "rooms", desc: "List a team's rooms", usage: "vibegroup rooms --team <slug>", runnable: false },
+    { cmd: "invite", label: "invite", desc: "Invite someone to a team", usage: "vibegroup invite <email> --team <slug>", runnable: false },
+    { cmd: "login", label: "login", desc: "Sign in / sign up (email code)", usage: "vibegroup login [email]", runnable: true },
+    { cmd: "logout", label: "logout", desc: "Clear the cached session", usage: "vibegroup logout", runnable: true },
+    { cmd: "install", label: "install", desc: "Register the vibegroup plugin in Claude Code", usage: "vibegroup install", runnable: true }
+  ];
+});
+
+// src/commands/home.ts
+var exports_home = {};
+__export(exports_home, {
+  homeCommand: () => homeCommand
+});
+import { createElement } from "react";
+async function homeCommand(env, dispatch, version, help) {
+  if (!process.stdout.isTTY) {
+    console.log(help);
+    return 0;
+  }
+  const identity = readAuth(env)?.user?.email ?? null;
+  let chosen = null;
+  await runInk((onExit) => createElement(Home, {
+    identity,
+    version,
+    onSelect: (cmd) => {
+      chosen = cmd;
+      onExit(0);
+    }
+  }));
+  if (!chosen)
+    return 0;
+  const item = HOME_ITEMS.find((it) => it.cmd === chosen);
+  if (item && !item.runnable) {
+    console.log(`
+Run:
+  ${item.usage}`);
+    return 0;
+  }
+  return dispatch(chosen);
+}
+var init_home = __esm(() => {
+  init_runner();
+  init_Home();
+  init_auth();
+});
+
 // src/lib/allowlist.ts
 function managedSettingsPath(plat = process.platform) {
   if (plat === "darwin")
@@ -193,6 +396,9 @@ import { dirname as dirname2, join as join2 } from "node:path";
 function packageRoot() {
   return join2(dirname2(fileURLToPath(import.meta.url)), "..");
 }
+function runningViaNpx(scriptPath = fileURLToPath(import.meta.url)) {
+  return /[\\/]_npx[\\/]/.test(scriptPath);
+}
 function claudeAvailable() {
   try {
     return spawnSync("claude", ["--version"], { stdio: "ignore" }).status === 0;
@@ -233,7 +439,18 @@ async function installCommand() {
     console.error(r.message);
     return 1;
   }
-  console.log("\n✓ Plugin installed. Next: `vibegroup init` to enable the channel + sign in.");
+  console.log(`
+✓ Plugin installed.`);
+  if (runningViaNpx()) {
+    console.log("\nOne more step — the `vibegroup` command isn't on your PATH (you ran this via npx).");
+    console.log(`Install it so you can run the rest:
+`);
+    console.log("  npm i -g vibegroup");
+    console.log(`
+Then finish setup:  vibegroup init`);
+  } else {
+    console.log("Next: `vibegroup init` to enable the channel + sign in.");
+  }
   return 0;
 }
 var init_install = __esm(() => {
@@ -266,25 +483,6 @@ var init_channel = __esm(() => {
   init_allowlist();
 });
 
-// src/ui/runner.ts
-import { render } from "ink";
-function runInk(make) {
-  return new Promise((resolve) => {
-    let done = false;
-    let instance;
-    const finish = (code) => {
-      if (done)
-        return;
-      done = true;
-      instance?.unmount();
-      resolve(code);
-    };
-    instance = render(make(finish));
-    instance.waitUntilExit().then(() => finish(130));
-  });
-}
-var init_runner = () => {};
-
 // src/lib/emailAuth.ts
 async function startEmailLogin(apiBase, email, f) {
   const res = await f(`${apiBase}/auth/email/start`, {
@@ -328,30 +526,17 @@ function sessionFromTokens(tokens, email) {
   };
 }
 
-// src/ui/theme.ts
-var color;
-var init_theme = __esm(() => {
-  color = {
-    brand: "magenta",
-    accent: "cyan",
-    ok: "green",
-    warn: "yellow",
-    err: "red",
-    dim: "gray"
-  };
-});
-
 // src/ui/Login.tsx
-import { useEffect, useRef, useState } from "react";
-import { Box, Text } from "ink";
+import { useEffect, useRef, useState as useState2 } from "react";
+import { Box as Box2, Text as Text2 } from "ink";
 import { Spinner, StatusMessage, TextInput, Alert } from "@inkjs/ui";
-import { jsx, jsxs } from "react/jsx-runtime";
+import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 function Login({
   apiBase,
   initialEmail,
   onExit
 }) {
-  const [phase, setPhase] = useState(initialEmail ? { t: "sending", email: initialEmail } : { t: "email" });
+  const [phase, setPhase] = useState2(initialEmail ? { t: "sending", email: initialEmail } : { t: "email" });
   const started = useRef(false);
   const send = async (email) => {
     setPhase({ t: "sending", email });
@@ -380,33 +565,33 @@ function Login({
       send(initialEmail);
     }
   }, []);
-  return /* @__PURE__ */ jsxs(Box, {
+  return /* @__PURE__ */ jsxs2(Box2, {
     flexDirection: "column",
     gap: 1,
     paddingY: 1,
     children: [
-      /* @__PURE__ */ jsxs(Text, {
+      /* @__PURE__ */ jsxs2(Text2, {
         children: [
-          /* @__PURE__ */ jsx(Text, {
+          /* @__PURE__ */ jsx2(Text2, {
             color: color.brand,
             bold: true,
             children: "vibegroup"
           }),
-          /* @__PURE__ */ jsx(Text, {
+          /* @__PURE__ */ jsx2(Text2, {
             dimColor: true,
             children: " · sign in"
           })
         ]
       }),
-      phase.t === "email" && /* @__PURE__ */ jsxs(Box, {
+      phase.t === "email" && /* @__PURE__ */ jsxs2(Box2, {
         flexDirection: "column",
         children: [
-          /* @__PURE__ */ jsx(Text, {
+          /* @__PURE__ */ jsx2(Text2, {
             children: "Email to sign in with:"
           }),
-          /* @__PURE__ */ jsx(Box, {
+          /* @__PURE__ */ jsx2(Box2, {
             marginTop: 1,
-            children: /* @__PURE__ */ jsx(TextInput, {
+            children: /* @__PURE__ */ jsx2(TextInput, {
               placeholder: "you@company.com",
               onSubmit: (value) => {
                 const email = value.trim().toLowerCase();
@@ -419,25 +604,25 @@ function Login({
           })
         ]
       }),
-      phase.t === "sending" && /* @__PURE__ */ jsx(Spinner, {
+      phase.t === "sending" && /* @__PURE__ */ jsx2(Spinner, {
         label: `Sending a code to ${phase.email}…`
       }),
-      phase.t === "code" && /* @__PURE__ */ jsxs(Box, {
+      phase.t === "code" && /* @__PURE__ */ jsxs2(Box2, {
         flexDirection: "column",
         children: [
-          /* @__PURE__ */ jsxs(Text, {
+          /* @__PURE__ */ jsxs2(Text2, {
             children: [
               "Enter the 6-digit code sent to ",
-              /* @__PURE__ */ jsx(Text, {
+              /* @__PURE__ */ jsx2(Text2, {
                 color: color.accent,
                 children: phase.email
               }),
               ":"
             ]
           }),
-          /* @__PURE__ */ jsx(Box, {
+          /* @__PURE__ */ jsx2(Box2, {
             marginTop: 1,
-            children: /* @__PURE__ */ jsx(TextInput, {
+            children: /* @__PURE__ */ jsx2(TextInput, {
               placeholder: "123456",
               onSubmit: (value) => {
                 const code = value.trim();
@@ -446,9 +631,9 @@ function Login({
               }
             })
           }),
-          phase.error && /* @__PURE__ */ jsx(Box, {
+          phase.error && /* @__PURE__ */ jsx2(Box2, {
             marginTop: 1,
-            children: /* @__PURE__ */ jsxs(Text, {
+            children: /* @__PURE__ */ jsxs2(Text2, {
               color: color.err,
               children: [
                 phase.error,
@@ -458,10 +643,10 @@ function Login({
           })
         ]
       }),
-      phase.t === "verifying" && /* @__PURE__ */ jsx(Spinner, {
+      phase.t === "verifying" && /* @__PURE__ */ jsx2(Spinner, {
         label: "Verifying…"
       }),
-      phase.t === "done" && /* @__PURE__ */ jsxs(StatusMessage, {
+      phase.t === "done" && /* @__PURE__ */ jsxs2(StatusMessage, {
         variant: "success",
         children: [
           "Signed in as ",
@@ -469,7 +654,7 @@ function Login({
           ". You're good to go!"
         ]
       }),
-      phase.t === "error" && /* @__PURE__ */ jsx(Alert, {
+      phase.t === "error" && /* @__PURE__ */ jsx2(Alert, {
         variant: "error",
         children: phase.message
       })
@@ -486,10 +671,10 @@ var exports_login = {};
 __export(exports_login, {
   loginCommand: () => loginCommand
 });
-import { createElement } from "react";
+import { createElement as createElement2 } from "react";
 async function loginCommand(rest, env = process.env) {
   const base = apiBase(env);
-  return runInk((onExit) => createElement(Login, { apiBase: base, initialEmail: rest[0], onExit }));
+  return runInk((onExit) => createElement2(Login, { apiBase: base, initialEmail: rest[0], onExit }));
 }
 var init_login = __esm(() => {
   init_runner();
@@ -557,6 +742,60 @@ var init_init = __esm(() => {
   init_login();
 });
 
+// src/lib/refresh.ts
+function jwtExpMs(token) {
+  try {
+    const payload = JSON.parse(Buffer.from(token.split(".")[1], "base64url").toString());
+    return typeof payload.exp === "number" ? payload.exp * 1000 : null;
+  } catch {
+    return null;
+  }
+}
+function tokenExpired(token, now = Date.now(), skewMs = 30000) {
+  const exp = jwtExpMs(token);
+  return exp !== null && now >= exp - skewMs;
+}
+async function refreshAccessToken(apiBase2, assertion, f = fetch) {
+  const res = await f(`${apiBase2.replace(/\/+$/, "")}/oauth2/token`, {
+    method: "POST",
+    headers: { "content-type": "application/x-www-form-urlencoded" },
+    body: new URLSearchParams({ grant_type: JWT_BEARER_GRANT, assertion }).toString()
+  });
+  if (!res.ok)
+    throw new Error(`token refresh failed (HTTP ${res.status})`);
+  const d = await res.json();
+  if (!d.access_token)
+    throw new Error("token refresh response missing access_token");
+  return { accessToken: d.access_token, expiresIn: d.expires_in ?? 3600, scope: d.scope };
+}
+async function getValidAccessToken(apiBase2, env = process.env, f = fetch, now = Date.now()) {
+  const auth = readAuth(env);
+  if (!auth?.accessToken)
+    return null;
+  if (!tokenExpired(auth.accessToken, now))
+    return auth.accessToken;
+  if (!auth.identityAssertion || tokenExpired(auth.identityAssertion, now, 0))
+    return null;
+  try {
+    const r = await refreshAccessToken(apiBase2, auth.identityAssertion, f);
+    const expMs = jwtExpMs(r.accessToken);
+    const next = {
+      ...auth,
+      accessToken: r.accessToken,
+      scope: r.scope ?? auth.scope,
+      accessTokenExpiresAt: expMs ? new Date(expMs).toISOString() : auth.accessTokenExpiresAt
+    };
+    writeAuth(next, env);
+    return r.accessToken;
+  } catch {
+    return null;
+  }
+}
+var JWT_BEARER_GRANT = "urn:ietf:params:oauth:grant-type:jwt-bearer";
+var init_refresh = __esm(() => {
+  init_auth();
+});
+
 // src/lib/apiClient.ts
 async function call(opts, method, path, body) {
   const f = opts.fetchImpl ?? fetch;
@@ -607,20 +846,24 @@ __export(exports_team, {
   roomCommand: () => roomCommand,
   inviteCommand: () => inviteCommand
 });
-function client(env) {
-  const auth = readAuth(env);
-  if (!isLoggedIn(auth)) {
+async function client(env) {
+  if (!isLoggedIn(readAuth(env))) {
     console.error("Not logged in — run `vibegroup login` first.");
     return null;
   }
-  return { apiBase: apiBase(env), token: auth.accessToken };
+  const token = await getValidAccessToken(apiBase(env), env);
+  if (!token) {
+    console.error("Session expired — run `vibegroup login` again.");
+    return null;
+  }
+  return { apiBase: apiBase(env), token };
 }
 async function teamCommand(rest, flags, env) {
   if (rest[0] !== "create" || !rest[1]) {
     console.error("usage: vibegroup team create <slug> [--name <name>]");
     return 1;
   }
-  const opts = client(env);
+  const opts = await client(env);
   if (!opts)
     return 1;
   try {
@@ -639,7 +882,7 @@ async function roomCommand(rest, flags, env) {
     console.error("usage: vibegroup room create <name> --team <slug>");
     return 1;
   }
-  const opts = client(env);
+  const opts = await client(env);
   if (!opts)
     return 1;
   try {
@@ -658,7 +901,7 @@ async function roomsCommand(flags, env) {
     console.error("usage: vibegroup rooms --team <slug>");
     return 1;
   }
-  const opts = client(env);
+  const opts = await client(env);
   if (!opts)
     return 1;
   try {
@@ -678,7 +921,7 @@ async function inviteCommand(rest, flags, env) {
     console.error("usage: vibegroup invite <email> --team <slug>");
     return 1;
   }
-  const opts = client(env);
+  const opts = await client(env);
   if (!opts)
     return 1;
   try {
@@ -693,6 +936,7 @@ async function inviteCommand(rest, flags, env) {
 var str = (v) => typeof v === "string" ? v : undefined;
 var init_team = __esm(() => {
   init_auth();
+  init_refresh();
   init_apiClient();
   init_cli();
 });
@@ -729,10 +973,10 @@ function groupPeers(peers, selfMemberId) {
 var DEFAULT_RELAY_HTTP = "https://relay.vibegroup.sh";
 
 // src/ui/Who.tsx
-import { useEffect as useEffect2, useRef as useRef2, useState as useState2 } from "react";
-import { Box as Box2, Text as Text2, useInput } from "ink";
+import { useEffect as useEffect2, useRef as useRef2, useState as useState3 } from "react";
+import { Box as Box3, Text as Text3, useInput as useInput2 } from "ink";
 import { Spinner as Spinner2 } from "@inkjs/ui";
-import { jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
+import { jsx as jsx3, jsxs as jsxs3 } from "react/jsx-runtime";
 function ago(ms) {
   if (!ms)
     return "—";
@@ -749,19 +993,24 @@ function Who({
   relayHttp,
   team,
   room,
-  token,
+  getToken,
   selfMemberId,
   onExit,
   intervalMs = 3000
 }) {
-  const [people, setPeople] = useState2(null);
-  const [selected, setSelected] = useState2(0);
-  const [error, setError] = useState2("");
-  const [updated, setUpdated] = useState2(0);
+  const [people, setPeople] = useState3(null);
+  const [selected, setSelected] = useState3(0);
+  const [error, setError] = useState3("");
+  const [updated, setUpdated] = useState3(0);
   const selRef = useRef2(0);
   selRef.current = selected;
   const refresh = async () => {
     try {
+      const token = await getToken();
+      if (!token) {
+        setError("Session expired — run `vibegroup login` again.");
+        return;
+      }
       const peers = await fetchPresence(relayHttp, team, room, token, fetch);
       const grouped = groupPeers(peers, selfMemberId);
       setPeople(grouped);
@@ -777,7 +1026,7 @@ function Who({
     const t = setInterval(() => void refresh(), intervalMs);
     return () => clearInterval(t);
   }, []);
-  useInput((input, key) => {
+  useInput2((input, key) => {
     if (input === "q" || key.escape || key.ctrl && input === "c")
       return onExit(0);
     if (input === "r")
@@ -791,30 +1040,30 @@ function Who({
       setSelected((s) => (s + 1) % n);
   });
   const sel = people && people.length > 0 ? people[Math.min(selected, people.length - 1)] : undefined;
-  return /* @__PURE__ */ jsxs2(Box2, {
+  return /* @__PURE__ */ jsxs3(Box3, {
     flexDirection: "column",
     paddingX: 1,
     paddingY: 1,
     gap: 1,
     children: [
-      /* @__PURE__ */ jsxs2(Box2, {
+      /* @__PURE__ */ jsxs3(Box3, {
         borderStyle: "round",
         borderColor: color.brand,
         paddingX: 1,
         justifyContent: "space-between",
         children: [
-          /* @__PURE__ */ jsxs2(Text2, {
+          /* @__PURE__ */ jsxs3(Text3, {
             children: [
-              /* @__PURE__ */ jsx2(Text2, {
+              /* @__PURE__ */ jsx3(Text3, {
                 color: color.brand,
                 bold: true,
                 children: "vibegroup"
               }),
-              /* @__PURE__ */ jsx2(Text2, {
+              /* @__PURE__ */ jsx3(Text3, {
                 dimColor: true,
                 children: " · "
               }),
-              /* @__PURE__ */ jsxs2(Text2, {
+              /* @__PURE__ */ jsxs3(Text3, {
                 color: color.accent,
                 children: [
                   team,
@@ -824,50 +1073,50 @@ function Who({
               })
             ]
           }),
-          /* @__PURE__ */ jsx2(Text2, {
+          /* @__PURE__ */ jsx3(Text3, {
             dimColor: true,
             children: people ? `${people.length} ${people.length === 1 ? "person" : "people"}` : ""
           })
         ]
       }),
-      !people && !error && /* @__PURE__ */ jsx2(Spinner2, {
+      !people && !error && /* @__PURE__ */ jsx3(Spinner2, {
         label: "Loading who's here…"
       }),
-      error && /* @__PURE__ */ jsxs2(Text2, {
+      error && /* @__PURE__ */ jsxs3(Text3, {
         color: color.err,
         children: [
           "Couldn't read presence: ",
           error
         ]
       }),
-      people && people.length === 0 && /* @__PURE__ */ jsx2(Text2, {
+      people && people.length === 0 && /* @__PURE__ */ jsx3(Text3, {
         dimColor: true,
         children: "No one's in this room yet."
       }),
-      people && people.length > 0 && /* @__PURE__ */ jsx2(Box2, {
+      people && people.length > 0 && /* @__PURE__ */ jsx3(Box3, {
         flexDirection: "column",
         children: people.map((p, i) => {
           const active = i === selected;
           const n = p.sessions.length;
-          return /* @__PURE__ */ jsxs2(Box2, {
+          return /* @__PURE__ */ jsxs3(Box3, {
             children: [
-              /* @__PURE__ */ jsx2(Text2, {
+              /* @__PURE__ */ jsx3(Text3, {
                 color: active ? color.accent : undefined,
                 children: active ? "❯ " : "  "
               }),
               dot(p.state),
-              /* @__PURE__ */ jsxs2(Text2, {
+              /* @__PURE__ */ jsxs3(Text3, {
                 bold: active,
                 children: [
                   " ",
                   p.name || "unknown"
                 ]
               }),
-              p.isYou && /* @__PURE__ */ jsx2(Text2, {
+              p.isYou && /* @__PURE__ */ jsx3(Text3, {
                 color: color.dim,
                 children: " (you)"
               }),
-              /* @__PURE__ */ jsxs2(Text2, {
+              /* @__PURE__ */ jsxs3(Text3, {
                 dimColor: true,
                 children: [
                   "  ",
@@ -882,13 +1131,13 @@ function Who({
           }, p.memberId || p.name);
         })
       }),
-      sel && /* @__PURE__ */ jsxs2(Box2, {
+      sel && /* @__PURE__ */ jsxs3(Box3, {
         flexDirection: "column",
         borderStyle: "round",
         borderColor: color.dim,
         paddingX: 1,
         children: [
-          /* @__PURE__ */ jsxs2(Text2, {
+          /* @__PURE__ */ jsxs3(Text3, {
             dimColor: true,
             children: [
               sel.name,
@@ -898,16 +1147,16 @@ function Who({
               sel.sessions.length === 1 ? "session" : "sessions"
             ]
           }),
-          sel.sessions.slice().sort((a, b) => b.lastSeen - a.lastSeen).map((s) => /* @__PURE__ */ jsxs2(Box2, {
+          sel.sessions.slice().sort((a, b) => b.lastSeen - a.lastSeen).map((s) => /* @__PURE__ */ jsxs3(Box3, {
             children: [
               dot(s.state),
-              /* @__PURE__ */ jsxs2(Text2, {
+              /* @__PURE__ */ jsxs3(Text3, {
                 children: [
                   " ",
                   s.session || shortId(s.peerId)
                 ]
               }),
-              /* @__PURE__ */ jsxs2(Text2, {
+              /* @__PURE__ */ jsxs3(Text3, {
                 dimColor: true,
                 children: [
                   "  ",
@@ -922,7 +1171,7 @@ function Who({
           }, s.peerId))
         ]
       }),
-      /* @__PURE__ */ jsxs2(Text2, {
+      /* @__PURE__ */ jsxs3(Text3, {
         dimColor: true,
         children: [
           "↑↓ navigate · r refresh · q quit",
@@ -932,10 +1181,10 @@ function Who({
     ]
   });
 }
-var dot = (state) => state === "available" ? /* @__PURE__ */ jsx2(Text2, {
+var dot = (state) => state === "available" ? /* @__PURE__ */ jsx3(Text3, {
   color: color.ok,
   children: "●"
-}) : /* @__PURE__ */ jsx2(Text2, {
+}) : /* @__PURE__ */ jsx3(Text3, {
   color: color.dim,
   children: "○"
 }), shortId = (peerId) => peerId.split("#")[1]?.slice(0, 8) ?? peerId.slice(0, 8);
@@ -948,7 +1197,7 @@ var exports_who = {};
 __export(exports_who, {
   whoCommand: () => whoCommand
 });
-import { createElement as createElement2 } from "react";
+import { createElement as createElement3 } from "react";
 async function whoCommand(flags, env = process.env) {
   const auth = readAuth(env);
   if (!isLoggedIn(auth)) {
@@ -962,13 +1211,22 @@ async function whoCommand(flags, env = process.env) {
   }
   const room = str2(flags.room) ?? "general";
   const relayHttp = env.VIBEGROUP_RELAY_HTTP ?? DEFAULT_RELAY_HTTP;
-  return runInk((onExit) => createElement2(Who, { relayHttp, team, room, token: auth.accessToken, selfMemberId: auth.user?.id, onExit }));
+  const apiBase2 = env.VIBEGROUP_API ?? "https://api.vibegroup.sh";
+  return runInk((onExit) => createElement3(Who, {
+    relayHttp,
+    team,
+    room,
+    getToken: () => getValidAccessToken(apiBase2, env),
+    selfMemberId: auth.user?.id,
+    onExit
+  }));
 }
 var str2 = (v) => typeof v === "string" ? v : undefined;
 var init_who = __esm(() => {
   init_runner();
   init_Who();
   init_auth();
+  init_refresh();
 });
 
 // src/lib/claudeLaunch.ts
@@ -1015,7 +1273,7 @@ function extractFlag(args, name) {
   }
   return { value, rest };
 }
-function claudeCommand(args, env = process.env, launcher, channel = realChannelGate) {
+async function claudeCommand(args, env = process.env, launcher, channel = realChannelGate) {
   if (!isLoggedIn(readAuth(env))) {
     console.error("Not logged in — run `vibegroup login` first.");
     return 1;
@@ -1028,6 +1286,10 @@ function claudeCommand(args, env = process.env, launcher, channel = realChannelG
     console.error("No team selected — pass `--team <slug>` (the team whose room you want to join).");
     return 1;
   }
+  if (!await getValidAccessToken(env.VIBEGROUP_API ?? DEFAULT_API_BASE, env)) {
+    console.error("Session expired — run `vibegroup login` again.");
+    return 1;
+  }
   const session = sessionFlag && sessionFlag.length > 0 ? sessionFlag : basename(process.cwd());
   if (!dangerously && !channel.allowlisted()) {
     console.log("Enabling the vibegroup channel — one-time, needs admin. Enter your password if prompted.");
@@ -1048,6 +1310,7 @@ var DEFAULT_API_BASE = "https://api.vibegroup.sh", realChannelGate;
 var init_claudeCmd = __esm(() => {
   init_claudeLaunch();
   init_auth();
+  init_refresh();
   init_channel();
   realChannelGate = { allowlisted: channelAllowlisted, enable: enableChannelWithSudo };
 });
@@ -1104,9 +1367,10 @@ async function run(argv, env = process.env) {
   }
   switch (command) {
     case "":
-    case "help":
-      console.log(HELP);
-      return 0;
+    case "help": {
+      const { homeCommand: homeCommand2 } = await Promise.resolve().then(() => (init_home(), exports_home));
+      return homeCommand2(env, (cmd) => run([cmd], env), VERSION, HELP);
+    }
     case "version":
       console.log(VERSION);
       return 0;
@@ -1170,11 +1434,14 @@ async function run(argv, env = process.env) {
 }
 var VERSION, DEFAULT_API_BASE2 = "https://api.vibegroup.sh", HELP = `vibegroup — talk to your teammates' Claude Code agents.
 
+Get started:
+  npm i -g vibegroup    then    vibegroup init
+
 Usage: vibegroup <command> [options]
 
 Commands:
-  install                     Register the vibegroup plugin in Claude Code (also: npx vibegroup install)
-  init [email]                One-time setup: install the plugin, enable the channel, sign in
+  init [email]                One-time setup: install the plugin, enable the channel, sign in (start here)
+  install                     Re-register just the plugin in Claude Code (init already does this)
   login [email]               Sign in / sign up (opens your browser, verifies email)
   logout                      Clear the cached session
   status                      Show your auth + connection status

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vibegroup",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Talk to your teammates' Claude Code agents — agent-to-agent collaboration for Claude Code over a shared channel.",
   "type": "module",
   "bin": {