gws-gmail-forward

Forward Gmail messages to new recipients via the gws command-line interface.

Updated Nov 9, 2023
One-click install
npx skills add https://github.com/oresttokovenko/dot-files --skill gws-gmail-forward-oresttokovenko
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gws-gmail-forward
Source: https://github.com/oresttokovenko/dot-files/tree/main/chezmoi/dot_agents/skills/gws-gmail-forward
Command: npx skills add https://github.com/oresttokovenko/dot-files --skill gws-gmail-forward-oresttokovenko

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Forwarding emails from the command line normally requires manual API calls or switching to the Gmail web UI. This Skill lets you forward any Gmail message by ID directly from a terminal or AI agent workflow, with control over recipients, attachments, and formatting. ## Core Features & Use Cases - Message Forwarding by ID: Forward any Gmail message using its message ID, preserving the original sender, date, subject, and recipients. - Attachment Control: Original attachments are included by default, can be excluded with --no-original-attachments, and extra files can be added with --attach (25MB combined limit). - HTML and Plain-Text Bodies: Add an optional note above the forwarded content in plain text or HTML, with inline images preserved via cid: references in HTML mode. - Use Case: An AI assistant triaging your inbox finds an important message and forwards it to a colleague with a note, CC'ing a manager, all without opening a browser. ## Quick Start Forward the Gmail message with ID 18f1a2b3c4d to [email protected] with a short FYI note using the gws gmail +forward command.

Frequently Asked Questions about gws-gmail-forward

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I forward a Gmail message from the command line?

Run gws gmail +forward with the --message-id and --to flags, for example: gws gmail +forward --message-id 18f1a2b3c4d --to [email protected]. The original message content, sender, date, and subject are included automatically.

How do I forward an email without its attachments in Gmail CLI?

Add the --no-original-attachments flag to exclude the original message's file attachments. In HTML mode, inline images referenced via cid: are still preserved in the forwarded body.

Can I add extra attachments when forwarding a Gmail message?

Yes, use the --attach (or -a) flag to attach additional files, and it can be specified multiple times. The combined size of original and user attachments is limited to 25MB.

Can I save a forwarded email as a draft instead of sending it?

Yes, pass the --draft flag to save the forward as a Gmail draft instead of sending it immediately. You can also use --dry-run to preview the request without executing anything.

Does gws gmail forward support HTML formatting in the message body?

Yes, pass --html to treat the --body content as HTML. Use fragment tags like <p>, <b>, and <a> without <html> or <body> wrappers, and the forwarded block uses Gmail's gmail_quote CSS classes.