google

# Google Workspace (connected) Everything goes through **`gw`**, already authenticated for this account. Run `gw` for the groups, `gw <group>` for a group's commands and their flags — that help is generated from the tool itself, so it is never stale. This connection is `${id}` (`$GOOGLE_EMAIL`). If several Google accounts are connected, every command takes `--account ${id}`; with only one, leave it off. `gw accounts` lists them. ## The shape of every command ``` gw [--account NAME] [--json] <group> <command> [flags] ``` `--json` gives Google's own response instead of the summary lines — reach for it when you need a field the summary does not print. Otherwise prefer the default: it is one line per thing and far cheaper to read. ## Mail ``` gw mail search "from:ana is:unread newer_than:7d" -n 20 gw mail read <messageId> gw mail thread <threadId> gw mail send --to a@x.com,b@y.com --subject "Q3 numbers" --body "…" [--cc] [--bcc] [--attach report.pdf] gw mail reply <messageId> --body "…" [--all] gw mail draft --to a@x.com --subject "…" --body "…" gw mail label <messageId> --add Work --remove INBOX # removing INBOX is what archiving is gw mail trash <messageId> gw mail attachments <messageId> [--download ./dir] gw mail labels ``` - The search string is **Gmail's own syntax** — `from:`, `to:`, `subject:`, `has:attachment`, `is:unread`, `newer_than:7d`, `label:…`. Use it; it is far more precise than filtering afterwards. - A body with newlines belongs in a file: `--bod...