threadly 0.2.1

CLI for the Threadly API
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
95
96
97
98
99

# Threadly CLI

A command-line interface for [Threadly](https://github.com/jasonkatz/threadly), an LLM-powered email classification service that integrates with Gmail.

## Installation

```bash
cargo install threadly
```

## Authentication

Threadly uses Google OAuth for authentication. The CLI handles this via device code flow:

```bash
threadly login    # Opens browser to authenticate with Google
threadly whoami   # Shows current user info
threadly logout   # Clears session
```

## Usage

### Buckets

Buckets are categories for organizing your emails. Default buckets are created automatically (Important, Can Wait, Newsletter, Auto-archive, Promotions).

```bash
threadly buckets list                           # List all buckets
threadly buckets create "Work" -d "Work emails" # Create a bucket
threadly buckets update <id> --name "New Name"  # Rename a bucket
threadly buckets delete <id>                    # Delete a bucket
```

### Threads

View email threads from your connected Gmail account:

```bash
threadly threads list                    # List recent threads
threadly threads list -n 100             # List 100 threads
threadly threads list --bucket <id>      # Filter by bucket
threadly threads get <id>                # Get thread details
```

### Classifications

Run LLM-powered classification to automatically sort your emails into buckets:

```bash
threadly classifications create          # Start a classification job
threadly classifications create --watch  # Start and watch progress
threadly classifications list            # List all classification jobs
threadly classifications get <id>        # Get job details
threadly classifications latest          # Get most recent completed job
threadly classifications watch <id>      # Watch a job in real-time
```

## Global Options

```
-l, --local    Use local development server (localhost:8080)
-r, --raw      Output raw JSON responses
-h, --help     Print help
-V, --version  Print version
```

## Command Aliases

For faster typing:

- `threadly b` = `threadly buckets`
- `threadly t` = `threadly threads`
- `threadly c` = `threadly classifications`

## Examples

Classify your inbox and watch the results:

```bash
threadly login
threadly c create --watch
```

View threads in a specific bucket:

```bash
threadly buckets list
threadly threads list --bucket <bucket-id>
```

Export classification data as JSON:

```bash
threadly --raw threads list > threads.json
```

## License

MIT