An open API service indexing awesome lists of open source software.

https://github.com/clawscli/claws

k9s-inspired TUI for AWS resource management with vim-style navigation
https://github.com/clawscli/claws

amazon-web-services aws bubbletea cli go k9s-like management-console resource-management terminal terminal-ui tui vim

Last synced: 13 days ago
JSON representation

k9s-inspired TUI for AWS resource management with vim-style navigation

Awesome Lists containing this project

README

          

[🇬🇧 English](README.md) | [🇨🇳 简体中文](README.zh-CN.md) | [🇰🇷 한국어](README.ko.md)

# claws

AWSリソース管理のためのターミナルUI

[![CI](https://github.com/clawscli/claws/actions/workflows/ci.yml/badge.svg)](https://github.com/clawscli/claws/actions/workflows/ci.yml)
[![Release](https://img.shields.io/github/v/release/clawscli/claws)](https://github.com/clawscli/claws/releases/latest)
[![Go Report Card](https://goreportcard.com/badge/github.com/clawscli/claws)](https://goreportcard.com/report/github.com/clawscli/claws)
[![Go Version](https://img.shields.io/badge/Go-1.25+-00ADD8?style=flat&logo=go)](https://go.dev/)
[![License](https://img.shields.io/badge/License-Apache%202.0-blue.svg)](LICENSE)

![claws デモ](docs/images/demo.gif)

## 機能

- **インタラクティブ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

## スクリーンショット

| リソースブラウザ | 詳細ビュー | アクションメニュー |
|------------------|------------|-------------------|
| ![browser](docs/images/resource-browser.png) | ![detail](docs/images/detail-view.png) | ![actions](docs/images/actions-menu.png) |

### マルチリージョン&マルチアカウント

![multi-region](docs/images/multi-account-region.png)

### AIチャット(Bedrock)

![ai-chat](docs/images/ai-chat.png)

リスト/詳細/差分ビューで`A`を押すとAIチャットが開きます。アシスタントがAWS Bedrockを使用してリソースの分析、設定の比較、リスクの特定を行います。

## インストール

### Homebrew(macOS/Linux)

```bash
brew install --cask clawscli/tap/claws
```

### インストールスクリプト(macOS/Linux)

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

### バイナリのダウンロード

[GitHub Releases](https://github.com/clawscli/claws/releases/latest)からダウンロードできます。

### Go Install

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

### Docker

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

## クイックスタート

```bash
# 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` | 終了します |

詳細は[キーバインド](docs/keybindings.ja.md)を参照してください。

## ドキュメント

| ドキュメント | 説明 |
|-------------|------|
| [キーバインド](docs/keybindings.ja.md) | キーボードショートカットの完全なリファレンス |
| [対応サービス](docs/services.ja.md) | 全70サービスと175リソース |
| [設定](docs/configuration.ja.md) | 設定ファイル、テーマ、オプション |
| [IAM権限](docs/iam-permissions.ja.md) | 必要なAWS権限 |
| [AIチャット](docs/ai-chat.ja.md) | AIアシスタントの使い方と機能 |
| [Architecture](docs/architecture.md) | 内部設計と構造 |
| [Adding Resources](docs/adding-resources.md) | コントリビューター向けガイド |

## 開発

### 前提条件

- Go 1.25+
- [Task](https://taskfile.dev/)(オプション)

### コマンド

```bash
task build # バイナリをビルド
task run # アプリケーションを実行
task test # テストを実行
task lint # リンターを実行
```

## 技術スタック

- **TUI**: [Bubbletea](https://github.com/charmbracelet/bubbletea) + [Lipgloss](https://github.com/charmbracelet/lipgloss)
- **AWS**: [AWS SDK for Go v2](https://github.com/aws/aws-sdk-go-v2)

## ライセンス

Apache License 2.0 - 詳細は[LICENSE](LICENSE)を参照してください。