README.zh-CN.md

🇬🇧 English | 🇯🇵 日本語 | 🇰🇷 한국어

claws

AWS 资源管理终端 UI

功能

• 交互式 TUI - 使用 vim 风格的快捷键浏览 AWS 资源
• 70 个服务、175 个资源 - 支持 EC2、S3、Lambda、RDS、ECS、EKS 等众多服务
• 多配置文件与多区域 - 并行查询多个账户和区域
• 配置文件登录辅助 - 可从配置文件选择器刷新 AWS SSO 会话或执行 AWS CLI aws login
• 资源操作 - 启动/停止实例、删除资源、追踪日志
• 跨资源导航 - 从 VPC 跳转到子网，从 Lambda 跳转到 CloudWatch
• 筛选与排序 - 模糊搜索、标签筛选、列排序
• 资源比较 - 并排差异对比视图
• AI 聊天 - 具备 AWS 上下文感知的 AI 助手（通过 Bedrock）
• 6 种配色主题 - dark、light、nord、dracula、gruvbox、catppuccin

截图

资源浏览器	详情视图	操作菜单

多区域与多账户

AI 聊天 (Bedrock)

在列表/详情/差异视图中按 A 即可打开 AI 聊天。助手会使用 AWS Bedrock 分析资源、比较配置并识别风险。

安装

Homebrew (macOS/Linux)

brew install --cask clawscli/tap/claws

安装脚本 (macOS/Linux)

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

下载二进制文件

从 GitHub Releases 下载。

Go 安装

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

Docker

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

快速开始

# 运行 claws（使用默认 AWS 凭证）
claws

# 指定配置文件
claws -p myprofile

# 指定区域
claws -r us-west-2

# 指定服务或视图启动
claws -s dashboard        # 从仪表板开始
claws -s services         # 从服务浏览器开始（默认）
claws -s ec2              # EC2 实例
claws -s rds/snapshots    # RDS 快照

# 启动时打开预筛选列表（需要 -s）
claws -s ec2 -f bastion           # 模糊筛选（相当于按 `/`）
claws -s ec2 --tag Role=bastion   # 标签筛选（相当于 `:tag`）

# 多个配置文件/区域（逗号分隔或重复指定）
claws -p dev,prod -r us-east-1,ap-northeast-1

# 只读模式（禁用破坏性操作）
claws --read-only

键盘快捷键

键	操作
j / k	上下移动
Enter / d	查看资源详情
:	命令模式（例如 :ec2/instances）
/	筛选模式（模糊搜索）
a	打开操作菜单
A	AI 聊天（列表/详情/差异视图）
R	选择区域
P	选择配置文件
l	对选中的配置文件进行 SSO 登录/刷新（配置文件选择器）
L	对选中的配置文件执行 AWS CLI aws login（配置文件选择器）
?	显示帮助
q	退出

详细信息请参阅键盘快捷键完整参考。

文档

文档	说明
键盘快捷键	完整的键盘快捷键参考
支持的服务	全部 70 个服务和 175 个资源
配置	配置文件、主题和选项
IAM 权限	所需的 AWS 权限
AI 聊天	AI 助手使用和功能
Architecture	内部设计和架构
Adding Resources	贡献者指南

开发

前置要求

• Go 1.25+
• Task（可选）

命令

task build          # 构建二进制文件
task run            # 运行应用程序
task test           # 运行测试
task lint           # 运行代码检查

技术栈

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

许可证

Apache License 2.0 - 详情请参阅 LICENSE。