🇯🇵 日本語 | 🇨🇳 简体中文 | 🇰🇷 한국어

claws

A terminal UI for AWS resource management

Features

• Interactive TUI - Navigate AWS resources with vim-style keybindings
• 70 services, 175 resources - EC2, S3, Lambda, RDS, ECS, EKS, and more
• Multi-profile & Multi-region - Query multiple accounts/regions in parallel
• Profile login helpers - Refresh AWS SSO sessions or run AWS CLI aws login from the profile selector
• Resource actions - Start/stop instances, delete resources, tail logs
• Cross-resource navigation - Jump from VPC to subnets, Lambda to CloudWatch
• Filtering & sorting - Fuzzy search, tag filtering, column sorting
• Resource comparison - Side-by-side diff view
• AI Chat - AI assistant with AWS context (via Bedrock)
• 6 color themes - dark, light, nord, dracula, gruvbox, catppuccin

Screenshots

Resource Browser	Detail View	Actions Menu

Multi-Region & Multi-Account

AI Chat (Bedrock)

Press A in list/detail/diff views to open AI chat. The assistant analyzes resources, compares configurations, and identifies risks using AWS Bedrock.

Installation

Homebrew (macOS/Linux)

brew install --cask clawscli/tap/claws

Install Script (macOS/Linux)

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

Download Binary

Download from GitHub Releases.

Go Install

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

Docker

docker run -it --rm -v ~/.aws:/home/claws/.aws:ro ghcr.io/clawscli/claws

Nix

nix profile add github:clawscli/claws
# or run it without installing to a profile:
nix run github:clawscli/claws -- ...

Quick Start

# Run claws (uses default AWS credentials)
claws

# With specific profile
claws -p myprofile

# With specific region
claws -r us-west-2

# Start directly on a service or view
claws -s dashboard        # Start with dashboard
claws -s services         # Start with service browser (default)
claws -s ec2              # EC2 instances
claws -s rds/snapshots    # RDS snapshots

# Launch into a pre-filtered list (requires -s)
claws -s ec2 -f bastion           # Fuzzy filter (like pressing `/`)
claws -s ec2 --tag Role=bastion   # Tag filter (like `:tag`)

# Multiple profiles/regions (comma-separated or repeated)
claws -p dev,prod -r us-east-1,ap-northeast-1

# Read-only mode (disables destructive actions)
claws --read-only

Key Bindings

Key	Action
j / k	Navigate up/down
Enter / d	View resource details
:	Command mode (e.g., :ec2/instances)
/	Filter mode (fuzzy search)
a	Open actions menu
A	AI Chat (in list/detail/diff views)
R	Select region(s)
P	Select profile(s)
l	SSO login/refresh for selected profile (in profile selector)
L	AWS CLI aws login for selected profile (in profile selector)
?	Show help
q	Quit

See docs/keybindings.md for complete reference.

Documentation

Document	Description
Key Bindings	Complete keyboard shortcuts reference
Supported Services	All 70 services and 175 resources
Configuration	Config file, themes, and options
IAM Permissions	Required AWS permissions
AI Chat	AI assistant usage and features
Architecture	Internal design and structure
Adding Resources	Guide for contributors

Development

Prerequisites

• Go 1.25+
• Task (optional)

Commands

task build          # Build binary
task run            # Run the application
task test           # Run tests
task lint           # Run linters

Tech Stack

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

License

Apache License 2.0 - see LICENSE for details.