Skip to content

clawscli/claws

Repository files navigation

claws

A terminal UI for AWS resource management

CI Release Go Report Card Go Version License

claws demo

Features

  • Interactive TUI - Navigate AWS resources with vim-style keybindings
  • 69 services, 169 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
browser detail actions

Multi-Region & Multi-Account

multi-region

AI Chat (Bedrock)

ai-chat

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

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 69 services and 163 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

License

Apache License 2.0 - see LICENSE for details.