evup — the EvUp.Cloud CLI

Authenticate against EvUp.Cloud and use the Anthropic proxy with per-plan model routing, all from your terminal.

$ evup login        # pair your device, get a token
$ evup profile      # who you are, what plan
$ evup plan         # show current plan
$ evup claude "fix" # run claude with your plan's models injected

Requires Node.js 18 or later (Node 20+ recommended for Ink).

Install

Recommended: install with your package manager

# npm
npm install -g @evup/cli

# pnpm — works with hoisted linker (default is fine), avoid
# `pnpm link --global` from a workspace checkout
pnpm add -g @evup/cli

# yarn
yarn global add @evup/cli

# bun
bun add -g @evup/cli

The CLI lands on your PATH as evup immediately.

Note on pnpm: pnpm's strict symlink layout can leave react (a peer of ink) unresolvable from the bundled dist/index.mjs if the install path is stale. If evup --help errors with ERR_MODULE_NOT_FOUND: react, run pnpm remove -g @evup/cli && rm -rf ~/.pnpm-store/v11/links/@evup ~/.pnpm-store/v11/links/@/ink-gradient then reinstall with pnpm add -g @evup/cli. npm, yarn, and bun aren't affected.

Try before you install

# pnpm
pnpm dlx @evup/cli <command>

# npm
npx @evup/cli <command>

# yarn
yarn dlx @evup/cli <command>

# bun
bunx @evup/cli <command>

To upgrade later:

npm update -g @evup/cli        # or pnpm update -g @evup/cli / yarn global upgrade @evup/cli / bun update -g @evup/cli

Sign in

evup login

The CLI prints a short code and a URL. Open the URL in any browser, sign in to EvUp.Cloud, paste the code, and click Approve. The CLI polls until you do, then saves the token locally so the next command doesn't have to ask again.

To sign out:

evup logout

Commands

| Command | What it does | | --------------------- | ------------------------------------------------------------------------------- | | evup login | Pair your device, save the access token. --open launches the browser for you. | | evup logout | Forget the stored credentials. | | evup profile | Show who you are, your plan, and the token expiry. | | evup org | List organizations, switch the active one with ↑/↓ + Enter. | | evup plan | Show current plan. evup plan upgrade plus opens checkout in the browser. | | evup claude [args…] | Run claude with the right ANTHROPIC_* env vars for your plan. |

evup <command> --help for options on every subcommand.

Troubleshooting

"Server unreachable" — the CLI is pointing at the wrong URL. If you're not a developer working on EvUp.Cloud itself, the default URL is what you want. Run evup profile to see what URL is configured; the fix is to ask whoever runs your EvUp deployment.

"Token expired" — run evup login again.

License

MIT — see LICENSE.