Skip to content
aws alfred workflow
Python Other
  1. Python 99.6%
  2. Other 0.4%
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
aws_workflow use boto3 for list of profiles Jan 16, 2018
icons added beanstalk environment lookup Dec 27, 2016


AWS workflow for Alfred 3.

This workflow allows you to search through various AWS resources by ID, name and/or tag.


You must have your AWS credentials set up in your ~/.aws directory:

$ cd ~/.aws
$ ls -l
total 8
-rw------- 1 twang staff 224 Nov 26 00:28 config
-rw------- 1 twang staff 706 Nov 18 00:01 credentials
$ cat config
region = us-east-1

[profile foo]
region = us-west-2
$ cat credentials
aws_access_key_id = xxxxxxxxxxxxxxxxxxxxx
aws_secret_access_key = xxxxxxxxxxxxxxxxxxxxx

aws_access_key_id = xxxxxxxxxxxxxxxxxxxxx
aws_secret_access_key = xxxxxxxxxxxxxxxxxxxxx


In Alfred Preferences, choose the AWS workflow and click the [x] icon to configure the WF_QUICKLOOK_PORT environment variable.


If not configured, quicklook will be disabled.


Select AWS Profile

Select the AWS profile to use by opening Alfred and typing:

aws >profile <profile name>


Open Alfred and type:

aws <query>

To perform a query against your selected profile. Alfred will then auto-populate results that are visible in your AWS account.

Modifier Key Cheat Sheet

Below is a table describing the currently supported AWS resource lookups and what Alfred will do upon hitting Enter when combined with modifier keys:

(none) Cmd Alt / Option Ctrl Shift (press, not hold)
CloudFormation Open stack in AWS console Quicklook
CloudWatch Log Group Open log group in AWS console Executes awslogs command in terminal for tailing (requires awslogs on your $PATH!) Copies awslogs tail command to clipboard Quicklook

Copies private IP Open instance in AWS console Copies public IP (if available) Quicklook

Elastic Beanstalk
Open environment in AWS Console Copies load balancer URL (if available) Quicklook

Open function in AWS console Open CloudWatch log group in AWS Console Quicklook

Copy endpoint URL Open cluster or node in AWS Console Quicklook

Open cluster in AWS console Copies first node's private IP (if available) Copies first node's public IP (if available) Quicklook

Open bucket in AWS Console Quicklook

Open queue in AWS console Copy queue URL Quicklook

... more resources and modifiers to be implemented. Feel free to fork this repo to implement your own!



Search queries can be in the form of a space separated list of facet:value or simply just value. Single (') or double (") quotes may be used for either the facet or value to allow for spaces, and escapes (\\) can be used to escape a literal apostrophe or quotation character. Furthermore, colons in facets and values can be specified by quoting the string (e.g.: url:'').

The available facets for each service, as well as the default facet if not provided, is specified for each service below.

EC2 Facets

If a bare value starts with i-, the workflow will search for exact prefix matches against the EC2 Instance Id. Otherwise, bare value queries will search the Name tag for the instance.

All other facets map to the tags on the instance. Note, all tag names are converted to lowercase.

S3 Facets

The default facet is the Name tag for the bucket.

All other facets map to the tags on the bucket. Note, all tag names are converted to lowercase.


Search for an EC2 Instance with a Role tag of webserver:

aws role:web

If the EC2 Instance also has a Environment tag of integration-testing, I can search multiple tags via:

aws role:web environment:test

If the EC2 instance also happens to be named my-test-application, I may further restrict my query:

aws role:web environment:test my te app

Open AWS Web Console

You can also open your browser to the AWS Web Console using the + leader prefix:

aws +<query>

See here for demo.


See Releases for a detailed list of changes between versions


You can’t perform that action at this time.