gws-gmail-readlisted

# gmail +read > **PREREQUISITE:** Read `gws-shared` for Ciaobot auth (via `ciao gws`), global flags, and security rules. Read a message and extract its body or headers ## Usage ```bash ciao gws "$GWS_PROFILE" gmail +read --id <ID> ``` ## Flags | Flag | Required | Default | Description | |------|----------|---------|-------------| | `--id` | ✓ | — | The Gmail message ID to read | | `--headers` | — | — | Include headers (From, To, Subject, Date) in the output | | `--format` | — | text | Output format (text, json) | | `--html` | — | — | Return HTML body instead of plain text | | `--dry-run` | — | — | Show the request that would be sent without executing it | ## Examples ```bash ciao gws "$GWS_PROFILE" gmail +read --id 18f1a2b3c4d ciao gws "$GWS_PROFILE" gmail +read --id 18f1a2b3c4d --headers ciao gws "$GWS_PROFILE" gmail +read --id 18f1a2b3c4d --format json | jq '.body' ``` ## Tips - Converts HTML-only messages to plain text automatically. - Handles multipart/alternative and base64 decoding.