{"id":16936087,"url":"https://github.com/tristanmorgan/awskeyring","last_synced_at":"2026-03-05T17:15:11.530Z","repository":{"id":40633463,"uuid":"115064921","full_name":"tristanmorgan/awskeyring","owner":"tristanmorgan","description":"Manage AWS creds and tokens in your macOS keychain with autocomplete.","archived":false,"fork":false,"pushed_at":"2025-02-04T01:10:53.000Z","size":499,"stargazers_count":25,"open_issues_count":0,"forks_count":1,"subscribers_count":17,"default_branch":"main","last_synced_at":"2025-04-02T08:12:23.581Z","etag":null,"topics":["autocomplete","aws","aws-console","gem","keychain","macos","ruby","temporary-credentials"],"latest_commit_sha":null,"homepage":"https://github.com/tristanmorgan/awskeyring/wiki","language":"Ruby","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tristanmorgan.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2017-12-22T01:53:39.000Z","updated_at":"2025-02-04T01:10:55.000Z","dependencies_parsed_at":"2023-10-11T01:35:22.333Z","dependency_job_id":"e8063a5a-0ce8-467c-81d3-0a69bbebcdf3","html_url":"https://github.com/tristanmorgan/awskeyring","commit_stats":{"total_commits":211,"total_committers":5,"mean_commits":42.2,"dds":"0.028436018957345932","last_synced_commit":"d9c62c45f9e416949d64b6ccc207478a727bb23e"},"previous_names":[],"tags_count":57,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tristanmorgan%2Fawskeyring","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tristanmorgan%2Fawskeyring/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tristanmorgan%2Fawskeyring/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tristanmorgan%2Fawskeyring/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tristanmorgan","download_url":"https://codeload.github.com/tristanmorgan/awskeyring/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248018061,"owners_count":21034048,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["autocomplete","aws","aws-console","gem","keychain","macos","ruby","temporary-credentials"],"created_at":"2024-10-13T20:56:02.933Z","updated_at":"2026-03-05T17:15:11.493Z","avatar_url":"https://github.com/tristanmorgan.png","language":"Ruby","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Awskeyring\n\n![Awskeyring](https://raw.githubusercontent.com/tristanmorgan/awskeyring/main/awskeyring-144.png)\n\n* ![Build Passing](https://github.com/tristanmorgan/awskeyring/actions/workflows/ruby.yml/badge.svg)\n* [![Gem Version](https://img.shields.io/gem/v/awskeyring)](https://badge.fury.io/rb/awskeyring)\n* [![license MIT](https://img.shields.io/badge/license-MIT-brightgreen.svg)](https://opensource.org/licenses/MIT)\n* [![All Downloads](https://img.shields.io/gem/dt/awskeyring)](https://rubygems.org/gems/awskeyring)\n* [![Version Downloads](https://img.shields.io/gem/dtv/awskeyring)](https://rubygems.org/gems/awskeyring)\n* [![Documentation](https://img.shields.io/badge/yard-docs-brightgreen.svg)](https://www.rubydoc.info/gems/awskeyring)\n\nAwskeyring is a small tool to manage AWS account keys in the macOS Keychain. It has\ngrown to incorporate a lot of [features](https://github.com/tristanmorgan/awskeyring/wiki/Awskeyring-features).\n\n## Project Status\n\nAwskeyring is a fairly mature project so it it doesn't see frequent updates but is still being maintained.\nIt is tested against the version of Ruby that is shipped with the latest version of macOS, but that ruby version is dated.\n\n## Motivation\n\nThe motivation of this application is to provide a local secure store of AWS\ncredentials using specifically in the macOS Keychain, to have them easily accessed\nfrom the Terminal, and to provide useful functions like assuming roles and opening\nthe AWS Console from the cli.\nFor Enterprise environments there are better suited tools to use\nlike [HashiCorp Vault](https://vaultproject.io/).\n\n## Installation\n\nInstall it with:\n\n    $ gem install awskeyring --user-install\n\nor via [homebrew gem](https://github.com/sportngin/brew-gem):\n\n    $ brew gem install awskeyring\n\n## Wiki\n\nPlease see the [Wiki](https://github.com/tristanmorgan/awskeyring/wiki) for full usage instructions and tips.\n\n## Quick start\n\nFirst you need to initialise your keychain to hold your AWS credentials.\n\n    $ awskeyring initialise\n\nThen add your keys to it.\n\n    $ awskeyring add personal-aws\n\nNow your keys are stored safely in the macOS keychain. To print environment variables run...\n\n    $ awskeyring env personal-aws\n\nAlternatively you can create a profile using the credential_process config variable. See the\n[AWS CLI Config docs](https://docs.aws.amazon.com/cli/latest/topic/config-vars.html#cli-aws-help-config-vars) for\nmore details on this config option.\n\n    [profile personal]\n    region = us-west-1\n    credential_process = /usr/local/bin/awskeyring json personal-aws\n\n## Usage\n\nThe CLI is using [Thor](http://whatisthor.com) with help provided interactively.\n\n    Awskeyring commands:\n      awskeyring --version, -v                # Prints the version\n      awskeyring add ACCOUNT                  # Adds an ACCOUNT to the keyring\n      awskeyring add-role ROLE                # Adds a ROLE to the keyring\n      awskeyring console ACCOUNT              # Open the AWS Console for the ACCOUNT\n      awskeyring env ACCOUNT                  # Outputs bourne shell environment exports for an ACCOUNT\n      awskeyring exec ACCOUNT command...      # Execute a COMMAND with the environment set for an ACCOUNT\n      awskeyring help [COMMAND]               # Describe available commands or one specific command\n      awskeyring import ACCOUNT               # Import an ACCOUNT to the keyring from ~/.aws/credentials\n      awskeyring initialise                   # Initialises a new KEYCHAIN\n      awskeyring json ACCOUNT                 # Outputs AWS CLI compatible JSON for an ACCOUNT\n      awskeyring list                         # Prints a list of accounts in the keyring\n      awskeyring list-role                    # Prints a list of roles in the keyring\n      awskeyring remove ACCOUNT               # Removes an ACCOUNT from the keyring\n      awskeyring remove-role ROLE             # Removes a ROLE from the keyring\n      awskeyring remove-token ACCOUNT         # Removes a token for ACCOUNT from the keyring\n      awskeyring rotate ACCOUNT               # Rotate access keys for an ACCOUNT\n      awskeyring token ACCOUNT [ROLE] [CODE]  # Create an STS Token from a ROLE or an mfa CODE\n      awskeyring update ACCOUNT               # Updates an ACCOUNT in the keyring\n\nand autocomplete that can be installed with:\n\n    $ complete -C /usr/local/bin/awskeyring awskeyring\n\nThere are also short forms of most commands if you prefer:\n\n    $ awskeyring ls\n\nTo set your environment easily the following bash function helps:\n\n    awsenv() { eval \"$(awskeyring env ${@:-$AWS_ACCOUNT_NAME})\"; }\n\n## Development\n\nAfter checking out the repo, run `bundle update` to install dependencies. Then, run `bundle exec rake` to run the\ntests. Run `bundle exec awskeyring` to use the gem in this directory, ignoring other installed copies of this gem.\nAwskeyring is tested against the last two versions of Ruby shipped with macOS.\n\nTo install this gem onto your local machine, run `bundle exec rake install`.\n\n## Security\n\nIf you believe you have found a security issue in Awskeyring, please responsibly disclose by contacting me at\n[tristan.morgan@gmail.com](mailto:tristan.morgan@gmail.com). Awskeyring is a Ruby script and as such Ruby is whitelisted\nto access your \"awskeyring\" keychain. Use a strong password and keep the unlock time short.\n\n## Contributing\n\nBug reports and pull requests are welcome on GitHub at [https://github.com/tristanmorgan/awskeyring](https://github.com/tristanmorgan/awskeyring).\nThis project is intended to be a safe, welcoming space for collaboration, and contributors are expected to adhere to\nthe [Contributor Covenant](https://contributor-covenant.org) code of conduct.\n\n### Contributors\n\n* Tristan [tristanmorgan](https://github.com/tristanmorgan)\n* Adam Sir [AzySir](https://github.com/AzySir)\n* Vito Giarrusso [thtliife](https://github.com/thtliife)\n\n## License\n\nThe gem is available as open source under the terms of the [MIT License](https://opensource.org/licenses/MIT).\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftristanmorgan%2Fawskeyring","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftristanmorgan%2Fawskeyring","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftristanmorgan%2Fawskeyring/lists"}