@rafay99/cvx 0.35.0 → 0.42.0

package/README.md

@@ -10,6 +10,19 @@ You link a project folder to an account **once**. After that, the moment you
 terminals — each grabs its own account as it launches and they all run at the
 same time.
 
+```
+  (◕‿◕)~@    happy — the right account is active
+  (⊙︵⊙)~@    alarmed — this project's team doesn't match the account
+  (–ᴗ–)ᶻ~@   asleep — the encrypted vault is locked
+  (◕‿<)~@    that's `cvx doctor` coming back clean
+```
+
+Meet **Vex**, the account chameleon. A chameleon changes color to match its
+surroundings; cvx changes your account to match your project — so Vex wears
+the **active account's color** and her face reacts to what's going on. Every
+account gets a stable color of its own, used across `accounts`, `ls`, and
+switch messages, so you learn to recognize where you are at a glance.
+
 ## Purpose
 
 The Convex CLI only remembers **one** logged-in account at a time — it lives in
@@ -145,6 +158,7 @@ bun run dev             # runs as work — both live simultaneously
 | `cvx refresh <account>` / `--all` | Re-authenticate one account — or every account in one sitting |
 | `cvx link <account> [path]` | Link a project dir (default cwd) to an account |
 | `cvx unlink [path]` | Remove a link |
+| `cvx scan [dir] [--depth N] [--yes]` | Auto-discover projects under a dir and link them to accounts by team |
 | `cvx rename <old> <new>` | Rename an account, keeping its links |
 | `cvx rm <account>` | Forget an account and its links |
 | `cvx use [account]` | Activate by name from anywhere — or this dir's account / an interactive pick |
@@ -160,7 +174,7 @@ bun run dev             # runs as work — both live simultaneously
 | `cvx vault <status\|encrypt\|decrypt\|unlock\|lock>` | Passphrase-encrypt stored tokens (unlock once per session) |
 | `cvx export [file]` / `cvx import <file>` | Encrypted vault backup / restore — new-machine setup in one command |
 | `cvx upgrade` | Check for a newer release and print the exact upgrade command |
-| `cvx doctor` | Check setup + per-account token health |
+| `cvx doctor [--fix]` | Check setup + per-account token health (`--fix` repairs hook/links/marker/tokens) |
 | `cvx completions <shell>` | Print a completion script (zsh/bash/fish/powershell) |
 | `cvx hook [--install] [--shell …]` | Install the cd-hook (zsh/bash/fish/nu/powershell) |
 
@@ -212,8 +226,9 @@ a single binary, so the split costs nothing at build time.
 bin/cvx.ts        entry point + command dispatch
 src/paths.ts      the ONE place HOME is resolved (CVX_HOME sandbox support)
 src/store.ts      data layer: vault I/O, the config swap, token verify
-src/ui.ts         the logo banner, first-run welcome, help
-src/colors.ts     the palette (edit here to re-theme)
+src/ui.ts         the gradient logo, Vex the mascot, welcome, help
+src/colors.ts     the palette: brand gradient + per-account colors (re-theme here)
+src/spinner.ts    braille spinner for network waits (TTY only)
 src/commands.ts   one function per subcommand
 src/hooks.ts      zsh / bash / PowerShell shell-hook snippets
 src/keychain.ts   OS keychain / DPAPI token backends

package/cvx.1

@@ -40,6 +40,16 @@ account may be linked to many projects.
 .B cvx unlink \fR[\fIpath\fR]
 Remove a link.
 .TP
+.B cvx scan \fR[\fIdir\fR] [\fB--depth\fR \fIN\fR] [\fB--yes\fR]
+Walk \fIdir\fR (default: the current directory) up to \fIN\fR levels deep
+(default 4), find Convex projects (a directory whose \fI.env.local\fR has a
+\fBCONVEX_DEPLOYMENT\fR line), and propose a link for each whose deployment team
+matches exactly one stored account. Hidden directories and \fBnode_modules\fR are
+skipped, and a project directory is never descended into. In an interactive
+terminal it asks before linking; otherwise \fB--yes\fR is required to apply.
+Already-linked directories are left untouched (a conflicting link is reported,
+never overwritten).
+.TP
 .B cvx rename \fIold\fR \fInew\fR
 Rename an account, keeping every link that pointed at it.
 .TP
@@ -117,11 +127,15 @@ Re-authenticate every stored account in one sitting (a browser sign-in each).
 Check for a newer cvx release and print the exact upgrade command for how it
 was installed (Homebrew, npm/bun, or GitHub tarball).
 .TP
-.B cvx doctor \fR[\fB--no-tokens\fR]
+.B cvx doctor \fR[\fB--no-tokens\fR] [\fB--fix\fR]
 Check your setup and report problems: Node/npx availability, whether you have a
 Convex login, vault integrity, the token storage backend, the active account,
 and whether the shell hook is installed. Also pings Convex to check each stored
-token's health (skip that with \fB--no-tokens\fR). Exits non-zero on any problem.
+token's health (skip that with \fB--no-tokens\fR). With \fB--fix\fR it repairs
+what it can \(em installs a missing shell hook, prunes dead links, clears a
+stale active marker, and (interactively) offers to re-authenticate rejected
+tokens; problems it fixes no longer force a non-zero exit. Exits non-zero on any
+remaining problem.
 .TP
 .B cvx welcome
 Show the welcome screen again.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rafay99/cvx",
-  "version": "0.35.0",
+  "version": "0.42.0",
   "description": "Switch Convex accounts per project automatically — run many Convex accounts across projects at once, no login/logout churn, no deploy keys, no tokens in your repos",
   "keywords": [
     "convex", "convex-dev", "convex-cli", "cli", "command-line",
@@ -19,10 +19,10 @@
   "files": ["launcher.cjs", "cvx.1", "README.md", "LICENSE"],
   "engines": { "node": ">=16" },
   "optionalDependencies": {
-    "@rafay99/cvx-darwin-arm64": "0.35.0",
-    "@rafay99/cvx-darwin-x64": "0.35.0",
-    "@rafay99/cvx-linux-x64": "0.35.0",
-    "@rafay99/cvx-linux-arm64": "0.35.0",
-    "@rafay99/cvx-win32-x64": "0.35.0"
+    "@rafay99/cvx-darwin-arm64": "0.42.0",
+    "@rafay99/cvx-darwin-x64": "0.42.0",
+    "@rafay99/cvx-linux-x64": "0.42.0",
+    "@rafay99/cvx-linux-arm64": "0.42.0",
+    "@rafay99/cvx-win32-x64": "0.42.0"
   }
 }