@rafay99/cvx 0.38.0 → 0.49.0

package/README.md

@@ -158,8 +158,10 @@ 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 rm <account>` | Forget an account and its links (asks on a TTY; `--force` skips) |
+| `cvx undo [--list]` | Restore the vault to before the last change — rm, rename, import, scan, all reversible |
 | `cvx use [account]` | Activate by name from anywhere — or this dir's account / an interactive pick |
 | `cvx run <account> -- <cmd>` | Run one command as `<account>` without changing the global login |
 | `cvx open` | Open the Convex dashboard for this project's deployment |
@@ -168,12 +170,12 @@ bun run dev             # runs as work — both live simultaneously
 | `cvx accounts` | List stored accounts (with when each token was last verified) |
 | `cvx ls` | List linked projects |
 | `cvx which [path]` | Print the account name for a dir (scripting) |
-| `cvx prompt` | Print the active account name (for a shell prompt segment) |
+| `cvx prompt [--starship\|--color]` | Prompt segment: bare name · starship config block · ANSI-colored name |
 | `cvx keychain <status\|enable\|disable>` | Store tokens in the OS keychain instead of a file |
 | `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) |
 

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
@@ -86,7 +96,7 @@ List linked projects; the current directory is marked.
 .B cvx which \fR[\fIpath\fR]
 Print the account name for a directory (exit 1 if none). For scripting.
 .TP
-.B cvx prompt
+.B cvx prompt \fR[\fB--starship\fR|\fB--color\fR]
 Print the active account name and nothing else \(em for embedding in a shell
 prompt. Fast and never errors.
 .SS Manage
@@ -99,6 +109,15 @@ Show or change where account tokens are stored. \fBenable\fR moves them into the
 OS keychain (macOS Keychain, libsecret on Linux, DPAPI on Windows); \fBdisable\fR
 moves them back to the chmod-600 file vault.
 .TP
+.B cvx undo \fR[\fB--list\fR] [\fB--yes\fR]
+Restore the vault (accounts, links, config, active marker) to how it was
+before the last change. A snapshot is taken automatically before every
+mutating command (rm, rename, unlink, import, scan, doctor --fix, storage
+migrations), capped at five. Running \fBundo\fR twice reverses the restore.
+Moving tokens to a more protected backend clears the history so old plaintext
+never lingers. OS-keychain secrets deleted from the keychain itself are not
+restorable.
+.TP
 .B cvx vault \fR<\fBstatus\fR|\fBencrypt\fR|\fBdecrypt\fR|\fBunlock\fR|\fBlock\fR>
 Passphrase-encrypt the stored tokens (AES-256-GCM, scrypt-derived key).
 \fBunlock\fR caches the key for the session (cleared by \fBlock\fR or a
@@ -117,11 +136,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.38.0",
+  "version": "0.49.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.38.0",
-    "@rafay99/cvx-darwin-x64": "0.38.0",
-    "@rafay99/cvx-linux-x64": "0.38.0",
-    "@rafay99/cvx-linux-arm64": "0.38.0",
-    "@rafay99/cvx-win32-x64": "0.38.0"
+    "@rafay99/cvx-darwin-arm64": "0.49.0",
+    "@rafay99/cvx-darwin-x64": "0.49.0",
+    "@rafay99/cvx-linux-x64": "0.49.0",
+    "@rafay99/cvx-linux-arm64": "0.49.0",
+    "@rafay99/cvx-win32-x64": "0.49.0"
   }
 }