cvx
personal
work
client
acme

Chamaeleo convexus

cvx switches your Convex account as you cd into each project, and every terminal keeps its own.

Can you spot her? She hides on one of four accounts.

brew install rafay99-epic/apps/cvx

ISpecimen

Other mascots watch your cursor. Vex watches your working directory. Each field mark is a feature.

  1. I. CASQUEHolds the vault: one token per account in ~/.convex-switch, mode 600.
  2. II. TURRET EYEWatches your working directory. The shell hook asks her on every cd.
  3. III. REFLEXcd to switch in about 23 ms. No network on the way.
  4. IV. FEETGrip one branch: a linked folder. Nested folders inherit the grip.
  5. V. SKINThe active account's color, the same one your terminal shows.
  6. VI. TAIL, THE @One session. Each terminal holds its own token, so parallel terminals never fight.
Chamaeleo convexus, adult, perched. Plate I.

IIHabitat

Your projects are twigs on one branch. Wherever she grips, she takes that folder's account. On an unlinked twig she asks which one.

  1. ~/code/webpersonal
  2. ~/code/billingwork
  3. ~/clients/atlasclient
  4. ~/scratchnot linked

cd ~/code/web → personal. This terminal now exports its own token.

IIIColony

One Vex per terminal, each on her own branch, all at once. Without cvx they share one global login. Tap the glass and each looks for herself.

With cvx: every terminal holds its own account, at the same time. Each tail is its own session token.

IVMoods, observed

Six moods, each one a real line from the CLI. Hover or focus a specimen to read it.

  1. happy09:02, after cd into billing

    ⇄ convex account → work

  2. wink09:40, doctor finds nothing wrong

    Everything looks good. ~ Vex approves (◕‿<)~@ ~

  3. ?

    curious10:15, an unlinked folder

    This directory isn't linked to an account.

  4. !

    alarm11:03, deployment owned by another team

    ▲ team mismatch: this project's deployment belongs to acme-labs

  5. z

    sleepy13:30, the vault is locked

    ⚿ vault locked: run cvx vault unlock to switch to work

  6. sad17:55, an account removed

    ✓ Removed account work · cvx undo restores it

A note on the casque. The default file vault keeps tokens in plaintext, readable only by you (mode 600). For encryption, use the OS keychain (cvx keychain enable) or the passphrase vault (cvx vault encrypt).

VAdopt

Type your account names and meet your Vexes. Colors are handed out in order, so your first eight accounts never share one.

cvx login personal
cvx login work
cvx login client
cvx login acme

Install

Homebrewbrew install rafay99-epic/apps/cvx
npmnpm install -g @rafay99/cvx
Bunbun add -g @rafay99/cvx
pnpmpnpm add -g @rafay99/cvx
then, oncecvx hook --install