README.md with usage example.

Author: pda

README.md

@@ -0,0 +1,61 @@
+aws-keychain
+============
+
+```
+aws-keychain    (c) 2014 Paul Annesley    MIT license.
+
+Store multiple AWS IAM access keys in Mac OS X keychain.
+Check out one of them at a time into ~/.aws/credentials
+
+Manage access keys in Keychain:
+  aws-keychain add <name> <access_key_id> <secret_access_key>
+  aws-keychain cat <name>
+  aws-keychain env <name>
+  aws-keychain ls
+  aws-keychain none
+  aws-keychain rm <name>
+  aws-keychain status
+  aws-keychain use <name>
+  eval `aws-keychain env <name>`
+```
+
+Example
+-------
+
+```
+$ aws-keychain status
+No access key at /Users/example/.aws/credentials
+
+$ aws-keychain ls
+cat: /Users/example/.aws/aws-keychain.list: No such file or directory
+
+$ aws-keychain add personal AKILNNK8O1KFMIZRQY1J QURSltVBG33e1qUxVhtsDw
+
+$ aws-keychain add work AKIJA9JFOPAKMH9AJPCJ LBCoZPXfQNVNRJbwN92pFQ
+
+$ aws-keychain ls
+personal
+work
+
+$ aws-keychain use personal
+
+$ aws-keychain status
+personal: AKILNNK3OPAKMIZRQY1J
+
+$ eval `aws-keychain env work`
+$ echo "$AWS_ACCESS_KEY_ID : $AWS_SECRET_ACCESS_KEY"
+AKIJA9JFOPAKMH9AJPCJ : LBCoZPXfQNVNRJbwN92pFQ
+
+$ aws-keychain rm work
+password has been deleted.
+
+$ aws-keychain ls
+personal
+
+$ aws-keychain none
+$ aws-keychain status
+No access key at /Users/example/.aws/credentials
+
+$ aws-keychain ls
+personal
+```