A terminal UI for AWS resource management 👮

• Interactive TUI - Navigate AWS resources with vim-style keybindings
• Mouse support - Click, scroll, hover for navigation
• Multi-service support - EC2, S3, IAM, RDS, Lambda, ECS, and 65+ more services (163 resources total)
• Resource actions - Start/stop instances, delete resources, tail logs
• Cross-resource navigation - Jump from VPC to subnets, from Lambda to CloudWatch Logs
• Profile & region switching - Switch AWS profiles (P) and regions (R) on the fly
• Multi-profile selection - Select multiple profiles with P, parallel fetch across accounts
• Multi-region selection - Select multiple regions with R, parallel fetch with aggregated results
• Command mode - Quick navigation with :ec2/instances syntax
• Tag search - Browse all tagged resources across regions with :tags command
• Filtering - Fuzzy search with /, tag filtering with :tag Env=prod
• Column sorting - Sort by any column with :sort <col> command
• Resource comparison - Side-by-side diff view with m to mark, d to compare
• Pagination - Handle large datasets with N key for next page

brew tap clawscli/tap
brew install --cask claws

curl -fsSL https://raw.githubusercontent.com/clawscli/claws/main/install.sh | sh

Options:

# Install specific version
curl -fsSL https://raw.githubusercontent.com/clawscli/claws/main/install.sh | VERSION=v0.1.6 sh

# Install to custom directory
curl -fsSL https://raw.githubusercontent.com/clawscli/claws/main/install.sh | INSTALL_DIR=/usr/local/bin sh

Security Note: Piping scripts directly to sh is convenient but bypasses inspection. For increased security, download and review the script first:

curl -fsSL https://raw.githubusercontent.com/clawscli/claws/main/install.sh -o install.sh
less install.sh  # Review the script
sh install.sh

Download from GitHub Releases:

# macOS (Apple Silicon)
curl -Lo claws.tar.gz https://github.com/clawscli/claws/releases/latest/download/claws-darwin-arm64.tar.gz
tar xzf claws.tar.gz && mv claws /usr/local/bin/

# macOS (Intel)
curl -Lo claws.tar.gz https://github.com/clawscli/claws/releases/latest/download/claws-darwin-amd64.tar.gz
tar xzf claws.tar.gz && mv claws /usr/local/bin/

# Linux (x86_64)
curl -Lo claws.tar.gz https://github.com/clawscli/claws/releases/latest/download/claws-linux-amd64.tar.gz
tar xzf claws.tar.gz && sudo mv claws /usr/local/bin/

# Linux (ARM64)
curl -Lo claws.tar.gz https://github.com/clawscli/claws/releases/latest/download/claws-linux-arm64.tar.gz
tar xzf claws.tar.gz && sudo mv claws /usr/local/bin/

# Windows (PowerShell)
Invoke-WebRequest -Uri https://github.com/clawscli/claws/releases/latest/download/claws-windows-amd64.zip -OutFile claws.zip
Expand-Archive claws.zip -DestinationPath .
# Add to PATH or move to desired location

go install github.com/clawscli/claws/cmd/claws@latest

git clone https://github.com/clawscli/claws.git
cd claws
go build -o claws ./cmd/claws

# Run claws (uses default AWS credentials)
claws

# Or with specific profile
claws -p myprofile

# Or with specific region
claws -r us-west-2

# Use environment credentials only (ignore ~/.aws config)
# Useful for EC2 instance profiles, ECS task roles, Lambda, etc.
claws -e

# Read-only mode (disables destructive actions)
claws --read-only
# or
CLAWS_READ_ONLY=1 claws

# Enable debug logging to file
claws -l debug.log

Selected regions are queried in parallel; resources display with Region column.

Selected profiles are queried in parallel; resources display with Profile and Account columns.

Login Details:

• :login runs aws login --remote using claws-login profile
• :login myprofile uses the specified profile name instead
• For SSO profiles, use P to open profile selector, then l for SSO login

Quick shortcuts for common services:

claws uses your standard AWS configuration:

• ~/.aws/credentials - AWS credentials
• ~/.aws/config - AWS configuration (region, profile)
• Environment variables: AWS_PROFILE, AWS_REGION, AWS_ACCESS_KEY_ID, etc.

Configuration is stored in ~/.config/claws/config.yaml for profile preferences.

For required IAM permissions, see docs/iam-permissions.md.

claws uses a simple architecture with custom implementations for each service:

claws/
├── cmd/claws/           # Entry point
├── internal/
│   ├── app/             # Main TUI application
│   ├── aws/             # AWS client management + helpers
│   ├── action/          # Action framework
│   ├── dao/             # Data Access Object interface
│   ├── log/             # Structured logging (slog-based)
│   ├── registry/        # Service registry + aliases
│   ├── render/          # Renderer interface
│   ├── ui/              # Theme system
│   └── view/            # View components
└── custom/              # Service implementations (DAO + Renderer + Actions)

See docs/architecture.md for details.

• Go 1.25+
• Task (optional, for task runner)

task build          # Build binary
task run            # Run the application
task test           # Run tests
task test-cover     # Run tests with coverage
task lint           # Run linters
task fmt            # Format code
task clean          # Clean build artifacts

See docs/adding-resources.md for a guide on adding new AWS resources.

Releases are automated via GoReleaser. Tag format controls which platforms are built:

Prereleases (tags containing -) skip Homebrew publishing.

• TUI Framework: Bubbletea + Lipgloss + Bubbles
• AWS SDK: AWS SDK for Go v2

Apache License 2.0 - see LICENSE for details.