cleam 0.1.0

Viewing and downloading Amazon CloudWatch Logs
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

# cleam

AWS CloudWatch Logs TUI viewer written in Rust.

Browse log groups, streams, and events interactively from your terminal.

```
┌─ cleam ──────────────────────────────────────────────────┐
│ AWS CloudWatch Logs                                      │
├──────────────────────┬───────────────────────────────────┤
│ Log Groups           │ Streams: /app/prod                │
│                      │                                   │
│ > /app/prod          │ > 2024/01/15/[$LATEST]abc123...   │
│   /app/stg           │   2024/01/15/[prod]def456...      │
│   /lambda/fn-a       │   2024/01/14/[$LATEST]xyz999...   │
├──────────────────────┴───────────────────────────────────┤
│ [Tab] Switch Panel  [Enter] Open Stream  [q] Quit       │
└──────────────────────────────────────────────────────────┘
```

## Features

- Browse log groups and streams side by side
- View log events (last 1 hour) in a full-screen list
- Filter events with CloudWatch filter patterns
- Open any event in a full-screen read-only viewer
- AWS SSO authentication support (`aws sso login`)
- Pagination with lazy loading

## Installation

```bash
cargo install --path .
```

Or build and run directly:

## Requirements

- AWS credentials configured (`~/.aws/config` or environment variables)
- For SSO: run `aws sso login` before starting cleam
- Set `AWS_PROFILE`

## Key Bindings

### Main screen (Log Groups / Streams)

| Key | Action |
|-----|--------|
| `Tab` | Switch between Groups and Streams panel |
| `j` / `↓` | Move cursor down |
| `k` / `↑` | Move cursor up |
| `Enter` | Open selected stream |
| `q` | Quit |

### Events screen

| Key | Action |
|-----|--------|
| `j` / `↓` | Move cursor down |
| `k` / `↑` | Move cursor up |
| `/` | Enter filter mode |
| `Enter` | Open selected event in viewer |
| `q` | Back to main screen |

### Filter input

| Key | Action |
|-----|--------|
| `Enter` | Apply filter pattern |
| `Esc` | Cancel filter input |

### Viewer screen

| Key | Action |
|-----|--------|
| `j` / `↓` | Scroll down |
| `k` / `↑` | Scroll up |
| `q` | Back to events screen |

## Configuration

cleam uses the standard AWS SDK configuration chain:

- `AWS_DEFAULT_REGION` environment variable
- `~/.aws/config` default profile
- AWS SSO profiles (`aws sso login`)
- IAM roles (EC2/ECS/Lambda environments)

No additional configuration needed.

## License

MIT