Tarmac AWS SQS Documentation
Learn how to connect Tarmac to AWS SQS, search and inspect messages, troubleshoot consumers, and safely redrive dead-letter queues.
Tarmac is a desktop client for AWS SQS. You fetch messages into a local cache, inspect them without another SQS call, and stage changes before they touch the queue.
Working with SQS
SQS is not a database. There is no way to browse a queue without side effects. Every message you receive starts a visibility timer, and every destructive action is a live API call against shared infrastructure. Three ideas shape how you work in Tarmac:
- Fetch once, inspect locally. Messages you fetch are cached on your machine with full-text search and faceted filters. You can search, filter, and re-read thousands of messages without touching SQS again.
- Visibility costs your consumers something. Tarmac receives with a 15-minute visibility timeout by default. While that timer runs, your real consumers cannot receive those messages, so pick a window that covers your review and no more. Live Tail holds each message for one second instead.
- Stage first, publish deliberately. Deletes, sends, and edited sends are staged locally. Nothing in that batch changes on the queue until you review it and press Publish Actions, and every action reports success or failure on its own. Queue-wide DLQ redrives start an AWS message-move task directly and cannot be staged.
Start here
Getting Started
Connect, fetch your first messages, and publish your first staged action.
Connecting to AWS
Credential modes, SSO, LocalStack, and the IAM permissions Tarmac needs.
Receiving Messages
Fetch controls, Live Tail, visibility timeouts, and the local cache.
Staged Actions
Stage deletes, sends, and edits, then publish them as a reviewed batch.
Features
Search & Filtering
Full-text search, derived facets, and date ranges over the local cache.
DLQ & Redrive
Inspect dead-letter queues and start or monitor queue-wide redrive tasks.
S3 Payloads
Detection and opt-in retrieval of large payloads offloaded to S3.
Topology
See SNS producers, dead-letter sources, and the redrive target for a queue.
Guides
SQS Essentials
The SQS semantics that shape every workflow: visibility, receipt handles, at-least-once delivery.
Search an SQS Queue
Find a message by ID, body text, or attribute with the AWS Console, the CLI, sqs-grep, or Tarmac.
View Messages Without Deleting
What a view changes on the queue, and how to give messages back to your consumers.
SQS GUI Tools Compared
The AWS Console, AWS Toolkits, QueueB, SQSCLI, Commandeer, sqs-grep, and Tarmac side by side.
Workflows
Recipes for debugging consumers, draining DLQs, and replaying poison messages.
Settings
External payload rules, local data management, and license controls.