Threadly CLI

A command-line interface for Threadly, an LLM-powered email classification service that integrates with Gmail.

Installation

cargo install threadly

Authentication

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

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).

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:

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:

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:

threadly login
threadly c create --watch

View threads in a specific bucket:

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

Export classification data as JSON:

threadly --raw threads list > threads.json

License

MIT