Home

SSM Explorer 🔍

A professional CLI tool for searching, filtering, and inspecting AWS SSM Parameter Store parameters.

What is SSM Explorer?

SSM Explorer is part of the Douklar DevOps Tools series. It provides a fast, feature-rich command-line interface for working with AWS Systems Manager (SSM) Parameter Store — with beautiful Rich terminal output, an interactive TUI browser, multi-account support, and scripting-friendly JSON mode.

Quick Navigation

Page	Description
Installation	How to install SSM Explorer via Poetry or pipx
Configuration	Config file, profile mapping, and auto-resolution
Commands	Full reference for all CLI commands
Multi-Account & Multi-Region	Working across AWS accounts and regions
Development	Contributing, linting, testing, project structure
FAQ & Troubleshooting	Common issues and fixes

Feature Highlights

🔍 Search parameters by path prefix (recursive or flat)
🎯 Filter by environment variable name or value pattern
📋 List all parameters under a path with ENV_VAR → value display
🖥️ Interactive Browse dynamic TUI parameter viewer (browse)
🌐 Deep Search across multiple profiles and regions simultaneously (deepsearch)
⚙️ Config Management view and set configurations directly from CLI (config)
📤 Export as .env or JSON file
🔐 SecureString decryption support
🗂️ Multi-profile AWS support via --profile
🌍 Multi-region support via --region
⚡ Fast batch fetching with automatic fallback
🖥️ Beautiful Rich terminal tables with pagination info
📦 JSON output mode for scripting and pipelines

Quick Start

# Install
cd SSM
poetry install
poetry run ssm-explorer install

# Verify setup
ssm-explorer check --profile my_profile_aws --region eu-west-1

# List parameters under a path
ssm-explorer list /my/app/config --profile my_profile_aws

# Interactively browse and filter parameters
ssm-explorer browse /my/app/config --profile my_profile_aws

# Deep search across multiple accounts and regions
ssm-explorer deepsearch --profile dev,prod --region us-east-1,eu-west-1 --filter-path DATABASE