Skip to content
nateshipsPublic

About

Assume any role, any cloud. Short-lived AWS, Azure, and Google Cloud credentials for your tools.

Topics

Resources

Contributing

Security policy

Stars

28 stars

Watchers

0 watching

Forks

Repository files navigation

rolle: the Go gopher behind three credential cards, next to the rolle wordmark

CI Latest release OpenSSF Scorecard OpenSSF Best Practices Renovate enabled License

rolle

Assume any role, any cloud.

rolle dashboard: tags, AWS accounts with their roles, IAM users, an Azure subscription, and Google Cloud projects, two sessions active

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 AssumeRole from any session. Add IAM users, with optional MFA, or sign in with console credentials in the browser, the flow behind aws login. Each active session is a profile backed by credential_process for 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 gcloud has. 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.

Install

brew install --cask nateships/tap/rolle

The cask installs the app and the rolle command. Windows and Linux builds are on the releases page. Docs: getrolle.com.

CLI

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.

Support

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.

Contributing

The contributing guide covers the commit convention, pull requests, and releases. The rest is specific to this repository.

Setup

mise install
mise run setup          # frontend deps and git hooks

Tools come from mise. Frontend and docs packages use aube.

Tasks

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 profiles

ROLLE_DEBUG=1, or rolle --debug, prints verbose diagnostics.

Layout

  • internal/core: domain model (integrations, sessions, credentials, workspace)
  • internal/app: application layer shared by the CLI and the desktop app
  • internal/aws, internal/azure, internal/gcp: cloud providers
  • internal/discover: import sources (AWS CLI, Granted, az CLI, gcloud, Leapp)
  • internal/awsconfig, internal/credcache, internal/secrets, internal/workspace: storage
  • internal/terminal: opens a terminal with a session's environment
  • cmd/rolle: CLI
  • apps/desktop: Wails v3 desktop app (React, Tailwind v4, shadcn/ui)
  • docs: the docs site for getrolle.com (Blume); docs/brand holds the brand kit

Read docs/brand/README.md before you change logos, app icons, typography, or brand colors.

License

GPL-3.0-or-later. The Go gopher artwork is by Renee French, adapted for rolle under CC BY 4.0.

About

Assume any role, any cloud. Short-lived AWS, Azure, and Google Cloud credentials for your tools.

Topics

Resources

Contributing

Security policy

Stars

28 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Used by

Contributors

Languages