Getting started

The Assume CLI

Everything the desktop app does, headless. The CLI connects to the running app over a local socket, so both share one workspace and one vault.

Install

Terminal

npm config set @assume:registry https://npm.atheeque.com
npm install -g @assume/cli

Requires Node.js 22+. The desktop app must be running — install it first.

Daily driving

Terminal

assume session list          # everything you can start
assume session start         # pick one interactively
assume session current       # which identity is live?
assume session stop          # done — credentials revoked

Beyond sessions

Terminal

assume integration login     # device-flow into AWS SSO
assume integration sync      # refresh accounts and roles
assume session open-web-console
assume region set-default

Every command is scriptable — start a session at the top of a deploy script, run your tooling, stop it at the end. CI boxes get the same short-lived credentials you do.