Sacha is a two-pane TUI inspired by classic file managers. It keeps you in the terminal while you explore AWS resources across seven services, with vim-style navigation, lazy-loaded pagination, and automatic JSON formatting.

sachamama comes from Quechua and means "mother of the forest." sacha shortens the idea to "forest," reflecting how the tool helps you see the bigger AWS landscape without getting lost in individual trees.

Prerequisites: AWS credentials configured (via ~/.aws/credentials, environment variables, or IAM role).

brew install sachamama/tap/sacha

go install github.com/sachamama/sacha/cmd/sacha@latest

Requires Go 1.22+.

Download from GitHub Releases:

# macOS (Apple Silicon)
curl -Lo sacha.tar.gz https://github.com/Sachamama/sacha/releases/latest/download/sacha_VERSION_darwin_arm64.tar.gz
tar xzf sacha.tar.gz && sudo mv sacha /usr/local/bin/

# macOS (Intel)
curl -Lo sacha.tar.gz https://github.com/Sachamama/sacha/releases/latest/download/sacha_VERSION_darwin_amd64.tar.gz
tar xzf sacha.tar.gz && sudo mv sacha /usr/local/bin/

# Linux (x86_64)
curl -Lo sacha.tar.gz https://github.com/Sachamama/sacha/releases/latest/download/sacha_VERSION_linux_amd64.tar.gz
tar xzf sacha.tar.gz && sudo mv sacha /usr/local/bin/

# Linux (ARM64)
curl -Lo sacha.tar.gz https://github.com/Sachamama/sacha/releases/latest/download/sacha_VERSION_linux_arm64.tar.gz
tar xzf sacha.tar.gz && sudo mv sacha /usr/local/bin/

Replace VERSION with the actual version (e.g., 1.0.0).

git clone https://github.com/Sachamama/sacha.git
cd sacha
make build  # binary at bin/sacha

# Homebrew
brew upgrade sacha

# Go install
go install github.com/sachamama/sacha/cmd/sacha@latest

# Pre-built binary — download from https://github.com/Sachamama/sacha/releases
# From source
git pull && make build

Check your current version: sacha --version

sacha
# or with explicit options
sacha --profile production --region us-east-1 --service cloudwatch-logs

Config file: ~/.config/sacha/config.json

Resolution precedence:

1. CLI flags (--profile, --region, --service)
2. Environment variables (AWS_PROFILE, AWS_REGION, AWS_DEFAULT_REGION)
3. Config file
4. AWS SDK defaults

Sacha remembers your last-used region and service automatically.

• Split-pane TUI — left pane lists log groups; right pane shows details or live tail output.
• Log group management — create (c), delete (d) with confirmation, set retention policy (R) with standard presets (1d to 1y or never).
• Multi-group tailing — select multiple groups with space/a and tail them simultaneously with t. Dynamic refresh when selection changes.
• Compact display — log group names show only the last path segment (e.g., /aws/lambda/my-func → my-func). Timestamps show the base time for the first event and relative offsets (+1.5s, +2m30s) for subsequent events.
• jq-style highlight — press H while tailing to enter field paths (e.g., .level .message .statusCode). Matching JSON values are highlighted in the log output.
• Filter by highlight — press F to toggle filtering: only events containing the highlighted fields are shown. Press F again to show all events.
• Panel focus — tab/h/l to switch between groups and tail panels. Focused panel highlighted with colored border.
• Fullscreen mode — press f while tailing for a distraction-free view with horizontal scrolling.
• Expand events — enter/space to open a scrollable popup with pretty-printed JSON.

• Bucket and object browser — navigate into buckets and folders with enter, go back with esc/backspace.
• Batch operations — multi-select files and folders with space, select all with a.
• Recursive downloads — press d to download selected files and folders to ./sacha-downloads/, preserving folder structure.
• Text preview — press p to preview file contents inline.
• Clipboard — y to copy S3 URI.
• Lazy pagination — loads more objects as you scroll near the bottom.

• Two-pane table browser — table list on the left, metadata on the right (status, item count, size, billing, key schema, GSIs).
• Item scanning — press enter to scan items with lazy-loaded pagination.
• Search & filter — / to filter tables or items by value.
• Expand items — enter/space to view full attribute details in a scrollable popup.
• All attribute types — strings, numbers, booleans, binary, sets, lists, and maps.
• Clipboard — y to copy table ARN.

• Function browser — two-pane view with runtime, handler, memory, timeout, code size, state, and architecture in the details panel.
• Deep inspection — enter/space to expand and view environment variables, layers, and full configuration.
• Filter by name or runtime — / to search.
• Clipboard — y to copy function ARN.
• Lazy pagination — loads more functions as you scroll.

• Hierarchical browsing — navigate path prefixes like folders with enter, go back with esc/backspace/h.
• Parameter details — value (with automatic decryption), type, version, last modified, ARN.
• All types supported — String, StringList, SecureString.
• Expand popup — enter/space on a parameter for full details.
• Clipboard — y to copy parameter value or path.
• Scroll memory — cursor position restored when navigating back.

• Queue browser — message counts (visible, in-flight, delayed), queue type, visibility timeout, redrive policy.
• Non-destructive peek — press enter to receive messages with visibility timeout 0 — messages stay in the queue.
• Message inspection — navigate messages, view auto-formatted JSON bodies, expand in a scrollable popup.
• Queue details popup — press space to view full queue attributes.
• Clipboard — y to copy queue URL or message body.
• Search/filter — / to filter queues by name.

• Instance browser — two-pane view with name, instance ID, type, state, public/private IPs, and launch time.
• Deep inspection — enter/space to expand and view full metadata including tags, security groups, VPC, and subnet.
• Filter — / to search by name, instance ID, type, state, or IP address.
• Clipboard — y to copy instance ID.
• Lazy pagination — loads more instances as you scroll.

Sacha uses a layered architecture built on Bubble Tea:

cmd/sacha/main.go          CLI entry point (Cobra)
internal/config/            Configuration (CLI > env > file > defaults)
internal/aws/               AWS SDK v2 abstraction + Service interface
internal/<service>/          Domain clients and types per service
internal/ui/<service>/       Bubble Tea models and views per service
internal/ui/app/             Main app shell (region/service switching)

Each service implements the awsx.Service interface and is registered in main.go. See the Contributing Guide for how to add a new service.

Sacha follows semantic versioning. Releases are tagged vMAJOR.MINOR.PATCH and automatically built via GoReleaser:

• Pre-built binaries for Linux, macOS, Windows (amd64 + arm64)
• Homebrew tap updates
• SHA256 checksums
• Auto-generated changelogs

Browse all releases: github.com/Sachamama/sacha/releases

Contributions are welcome! Please read the Contributing Guide for details on the development workflow, coding standards, commit conventions, and how to add new AWS services.

MIT © Sachamama