Assume any role, any cloud.
rolle is a desktop app and a CLI. It hands short-lived AWS, Azure, and Google Cloud credentials to your tools and writes no secret to disk.
- AWS. Sign in to IAM Identity Center once and get every account and role you can reach. Chain
AssumeRolefrom any session. Add IAM users, with optional MFA, or sign in with console credentials in the browser, the flow behindaws login. Each active session is a profile backed bycredential_processfor the AWS CLI and the SDKs. - Azure. Sign in to an Entra ID tenant. Each subscription is a session that yields Resource Manager tokens.
- Google Cloud. Reuse the credentials
gcloudhas. Each project is a session. Impersonate service accounts. - Desktop app. Expiry countdowns, favorites, tags, one-click console and terminal, a tray menu, and signed self-updates.
- Secrets live in the OS keychain. Short-lived credentials are owner-only files that expire.
- No telemetry. rolle connects only to the clouds you sign in to and to GitHub releases for the update check. The update check can be turned off.
rolle imports what your machine has: Identity Center portals from the AWS CLI and Granted, tenants from the az CLI, gcloud credentials, and a Leapp workspace.
brew install --cask nateships/tap/rolleThe cask installs the app and the rolle command. Windows and Linux builds are on the releases page. Docs: getrolle.com.
rolle integration add aws-sso --alias acme --start-url https://acme.awsapps.com/start --region us-east-1
rolle integration login acme
rolle start "Acme Prod/AdministratorAccess"
aws sts get-caller-identity --profile default--json and stable exit codes support scripts. See the CLI reference and Agents and scripts.
Open an issue. In the app, Help → Report a problem fills in your version and platform, and Support bundle writes a redacted zip to attach. It redacts account ids, emails, hosts, and secrets.
For a security problem, do not open an issue. Use private vulnerability reporting. The security policy says what to include and what to expect. Security model describes what the project does today.
The contributing guide covers the commit convention, pull requests, and releases. The rest is specific to this repository.
mise install
mise run setup # frontend deps and git hooksTools come from mise. Frontend and docs packages use aube.
mise run check # go vet, lint, tests
mise run check:frontend # typecheck, lint, format, tests
mise run hooks # every pre-commit hook on the whole tree
mise run desktop # the desktop app in dev mode
mise run desktop:demo # the same, on fictional data
mise run cli -- <args> # the CLI from source, for example: mise run cli -- integration list
mise run capabilities:check # compare the Go capability graph with capslock.json; mise run capabilities rewrites it
mise run regions:check # compare the desktop region picker with the AWS SDK's partition table; mise run regions rewrites it
mise run icons # regenerate the desktop and tray icons after a brand change; the outputs are committed
mise run docs # serve the docs site
mise run reset # wipe the local workspace, secrets, cache, and AWS profilesROLLE_DEBUG=1, or rolle --debug, prints verbose diagnostics.
internal/core: domain model (integrations, sessions, credentials, workspace)internal/app: application layer shared by the CLI and the desktop appinternal/aws,internal/azure,internal/gcp: cloud providersinternal/discover: import sources (AWS CLI, Granted, az CLI, gcloud, Leapp)internal/awsconfig,internal/credcache,internal/secrets,internal/workspace: storageinternal/terminal: opens a terminal with a session's environmentcmd/rolle: CLIapps/desktop: Wails v3 desktop app (React, Tailwind v4, shadcn/ui)docs: the docs site for getrolle.com (Blume);docs/brandholds the brand kit
Read docs/brand/README.md before you change logos, app icons, typography, or brand colors.
GPL-3.0-or-later. The Go gopher artwork is by Renee French, adapted for rolle under CC BY 4.0.
