Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
170 changes: 170 additions & 0 deletions Cargo.lock

Some generated files are not rendered by default. Learn more about how customized files appear on GitHub.

2 changes: 2 additions & 0 deletions Cargo.toml
Original file line number Diff line number Diff line change
Expand Up @@ -21,8 +21,10 @@ strip = true
[dependencies]
anyhow = "1.0.102"
aws-config = { version = "1.8.15", features = ["behavior-version-latest"] }
aws-sdk-cloudwatch = "1"
aws-sdk-sns = "1.98.0"
aws-sdk-sqs = "1.97.0"
aws-smithy-types = "1"
aws-types = "1.3.14"
crossterm = "0.29.0"
dirs = "6.0.0"
Expand Down
30 changes: 26 additions & 4 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -28,10 +28,11 @@ cargo build --release
- Browse SQS queues with message counts (visible, in-flight, delayed)
- Browse SNS topics with subscription counts
- Detailed attribute views for individual queues and topics
- SQS queue insights with CloudWatch-backed drain, ETA, age, and pressure signals
- SNS → SQS subscription exploration with filter policies
- Visual dependency map showing topic-to-queue edges (ASCII tree)
- Multi-profile and multi-region support (16 AWS regions)
- Search and filter by name, sort by name or message count
- Search and filter by name with friendly wildcards (`*-dlq`, `prod-*`, `queue-??`) and combined terms (`prod *-dlq`), sort by name or message count
- Multi-select resources for dependency analysis
- Copy context to clipboard in markdown format
- Profile and region persistence across sessions
Expand All @@ -41,6 +42,26 @@ cargo build --release
- Rust 2024 edition
- AWS credentials configured in `~/.aws/config` and/or `~/.aws/credentials`

## AWS Permissions

To use the application fully, the active AWS identity needs read-only access to SQS, SNS, and CloudWatch in the selected account and region.

Minimum permissions for the existing browse/detail flows:

- `sqs:ListQueues`
- `sqs:GetQueueAttributes`
- `sns:ListTopics`
- `sns:GetTopicAttributes`
- `sns:ListSubscriptions`
- `sns:ListSubscriptionsByTopic`
- `sns:GetSubscriptionAttributes`

Additional permission for the SQS insight block in queue detail:

- `cloudwatch:GetMetricData`

If `cloudwatch:GetMetricData` is missing, the queue detail still opens and raw SQS attributes still work, but the insights block will show partial/unavailable values and the status bar will display a warning.

## Build & Run

```bash
Expand All @@ -54,7 +75,8 @@ cargo build --release

| Key | Action |
|-----|--------|
| `q` / `Ctrl+C` | Quit |
| `q` | Open quit confirmation |
| `Ctrl+C` | Quit immediately |
| `1` | Switch to SQS list |
| `2` | Switch to SNS list |
| `?` | Toggle help |
Expand All @@ -70,7 +92,7 @@ cargo build --release
| `↑` / `k` | Cursor up |
| `↓` / `j` | Cursor down |
| `Enter` | Open detail view |
| `/` | Start search (filter by name) |
| `/` | Start search (filter by name, supports `*` and `?`) |
| `s` | Cycle sort: Name → Messages ↓ → Messages ↑ (SQS only) |
| `Space` | Toggle selection |
| `m` | Open dependency map (requires selections) |
Expand All @@ -83,7 +105,7 @@ cargo build --release
| `Tab` | Switch focus between panels |
| `↑` / `k` | Scroll up |
| `↓` / `j` | Scroll down |
| `Esc` | Back to list |
| `Esc` | Back / cancel / close modal |

### Search mode

Expand Down
Loading
Loading