Kue is a terminal user interface (tui) application designed for managing aws sqs (simple queue service). It provides an intuitive and efficient way to interact with your sqs queues directly from the terminal. With Kue, you can easily create, delete, and manage messages within your queues, making it an essential tool for engineers who prefer working within a terminal environment.

views

• queue: overview, details, creation, delete
• message: details, creation, delete

keybindings

• q, esc, ctrl+c: quit/return
• ↑, k: up
• ↓, j: down
• →, l: right
• ←, h: left
• ctrl + d: delete queue/message
• ctrl + n: create queue/message
• ?: help
• enter: view
• space: select
• /: filter

demonstration

queue overview

queue details

message details

message creation

message delete

queue creation

queue delete

development

Kue uses LocalStack running in Docker to simulate AWS SQS locally. This allows you to develop and test without connecting to real AWS services.

• docker
• localstack
• earthly
• go 1.23+

docker run --rm -d \
  --name localstack \
  -p 4566:4566 \
  -e SERVICES=sqs \
  localstack/localstack

export AWS_ENDPOINT_URL=http://localhost:4566
export AWS_ACCESS_KEY_ID=default
export AWS_SECRET_ACCESS_KEY=default
export AWS_DEFAULT_REGION=us-east-1

The project includes an Earthfile with targets to quickly set up sample SQS queues and messages for development.

create sample queues

earthly +queues

send sample messages

earthly +messages

To show the changes made in the repository readme, the following command can be ran which automatically creates the preview gif & screenshots:

earthly +vhs

running kontrolplan/kue locally

After setting up LocalStack and creating sample resources build and run:

earthly +local && ./build/kontrolplane/kue

contributors