my-project-public

repository

loading code, commits, and activity

repositories

loading repo index

#1	---
#2	name: gog
#3	description: Google Workspace CLI for Gmail, Calendar, Drive, Contacts, Sheets, and Docs.
#4	homepage: https://gogcli.sh
#5	metadata: {"clawdbot":{"emoji":"🎮","requires":{"bins":["gog"]},"install":[{"id":"brew","kind":"brew","formula":"steipete/tap/gogcli","bins":["gog"],"label":"Install gog (brew)"}]}}
#6	---
#7
#8	# gog
#9
#10	Use `gog` for Gmail/Calendar/Drive/Contacts/Sheets/Docs. Requires OAuth setup.
#11
#12	Setup (once)
#13	- `gog auth credentials /path/to/client_secret.json`
#14	- `gog auth add you@gmail.com --services gmail,calendar,drive,contacts,docs,sheets`
#15	- `gog auth list`
#16
#17	Common commands
#18	- Gmail search: `gog gmail search 'newer_than:7d' --max 10`
#19	- Gmail messages search (per email, ignores threading): `gog gmail messages search "in:inbox from:ryanair.com" --max 20 --account you@example.com`
#20	- Gmail send (plain): `gog gmail send --to a@b.com --subject "Hi" --body "Hello"`
#21	- Gmail send (multi-line): `gog gmail send --to a@b.com --subject "Hi" --body-file ./message.txt`
#22	- Gmail send (stdin): `gog gmail send --to a@b.com --subject "Hi" --body-file -`
#23	- Gmail send (HTML): `gog gmail send --to a@b.com --subject "Hi" --body-html "<p>Hello</p>"`
#24	- Gmail draft: `gog gmail drafts create --to a@b.com --subject "Hi" --body-file ./message.txt`
#25	- Gmail send draft: `gog gmail drafts send <draftId>`
#26	- Gmail reply: `gog gmail send --to a@b.com --subject "Re: Hi" --body "Reply" --reply-to-message-id <msgId>`
#27	- Calendar list events: `gog calendar events <calendarId> --from <iso> --to <iso>`
#28	- Calendar create event: `gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso>`
#29	- Calendar create with color: `gog calendar create <calendarId> --summary "Title" --from <iso> --to <iso> --event-color 7`
#30	- Calendar update event: `gog calendar update <calendarId> <eventId> --summary "New Title" --event-color 4`
#31	- Calendar show colors: `gog calendar colors`
#32	- Drive search: `gog drive search "query" --max 10`
#33	- Contacts: `gog contacts list --max 20`
#34	- Sheets get: `gog sheets get <sheetId> "Tab!A1:D10" --json`
#35	- Sheets update: `gog sheets update <sheetId> "Tab!A1:B2" --values-json '[["A","B"],["1","2"]]' --input USER_ENTERED`
#36	- Sheets append: `gog sheets append <sheetId> "Tab!A:C" --values-json '[["x","y","z"]]' --insert INSERT_ROWS`
#37	- Sheets clear: `gog sheets clear <sheetId> "Tab!A2:Z"`
#38	- Sheets metadata: `gog sheets metadata <sheetId> --json`
#39	- Docs export: `gog docs export <docId> --format txt --out /tmp/doc.txt`
#40	- Docs cat: `gog docs cat <docId>`
#41
#42	Calendar Colors
#43	- Use `gog calendar colors` to see all available event colors (IDs 1-11)
#44	- Add colors to events with `--event-color <id>` flag
#45	- Event color IDs (from `gog calendar colors` output):
#46	- 1: #a4bdfc
#47	- 2: #7ae7bf
#48	- 3: #dbadff
#49	- 4: #ff887c
#50	- 5: #fbd75b
#51	- 6: #ffb878
#52	- 7: #46d6db
#53	- 8: #e1e1e1
#54	- 9: #5484ed
#55	- 10: #51b749
#56	- 11: #dc2127
#57
#58	Email Formatting
#59	- Prefer plain text. Use `--body-file` for multi-paragraph messages (or `--body-file -` for stdin).
#60	- Same `--body-file` pattern works for drafts and replies.
#61	- `--body` does not unescape `\n`. If you need inline newlines, use a heredoc or `$'Line 1\n\nLine 2'`.
#62	- Use `--body-html` only when you need rich formatting.
#63	- HTML tags: `<p>` for paragraphs, `<br>` for line breaks, `<strong>` for bold, `<em>` for italic, `<a href="url">` for links, `<ul>`/`<li>` for lists.
#64	- Example (plain text via stdin):
#65	```bash
#66	gog gmail send --to recipient@example.com \
#67	--subject "Meeting Follow-up" \
#68	--body-file - <<'EOF'
#69	Hi Name,
#70
#71	Thanks for meeting today. Next steps:
#72	- Item one
#73	- Item two
#74
#75	Best regards,
#76	Your Name
#77	EOF
#78	```
#79	- Example (HTML list):
#80	```bash
#81	gog gmail send --to recipient@example.com \
#82	--subject "Meeting Follow-up" \
#83	--body-html "<p>Hi Name,</p><p>Thanks for meeting today. Here are the next steps:</p><ul><li>Item one</li><li>Item two</li></ul><p>Best regards,<br>Your Name</p>"
#84	```
#85
#86	Notes
#87	- Set `GOG_ACCOUNT=you@gmail.com` to avoid repeating `--account`.
#88	- For scripting, prefer `--json` plus `--no-input`.
#89	- Sheets values can be passed via `--values-json` (recommended) or as inline rows.
#90	- Docs supports export/cat/copy. In-place edits require a Docs API client (not in gog).
#91	- Confirm before sending mail or creating events.
#92	- `gog gmail search` returns one row per thread; use `gog gmail messages search` when you need every individual email returned separately.
#93

z6Mkq5mY3JWtxoxUobWcfNHm7AkRubgSWEZTkBVqZXJviFZ5/my-project-public