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

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
• 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

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

# 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) | | ? | 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.