Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion .agents/skills/gog-admin/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-admin
description: "Workspace Admin operations through gog."
description: "Workspace Admin through gog. Use for Workspace Admin Directory users, groups, and organizational units; use gog-groups for Cloud Identity group membership lookup."
---

# Workspace Admin
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-adsense/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-adsense
description: "Google AdSense operations through gog."
description: "Google AdSense through gog. Use for AdSense accounts, sites, payments, and earnings reports."
---

# Google AdSense
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-analytics/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-analytics
description: "Google Analytics operations through gog."
description: "Google Analytics through gog. Use for Google Analytics account summaries and GA4 reports."
---

# Google Analytics
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-appscript/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-appscript
description: "Apps Script operations through gog."
description: "Apps Script through gog. Use for Apps Script projects, source files, deployments, and executions."
---

# Apps Script
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-calendar/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-calendar
description: "Google Calendar operations through gog."
description: "Google Calendar through gog. Use for calendars, events, availability, and scheduling; use gog-meeting-prep for meeting briefings or gog-weekly-digest for a cross-service summary."
---

# Google Calendar
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-chat/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-chat
description: "Google Chat operations through gog."
description: "Google Chat through gog. Use for Google Chat spaces, messages, threads, and members."
---

# Google Chat
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-classroom/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-classroom
description: "Google Classroom operations through gog."
description: "Google Classroom through gog. Use for Classroom courses, rosters, coursework, submissions, and announcements."
---

# Google Classroom
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-contacts/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-contacts
description: "Google Contacts operations through gog."
description: "Google Contacts through gog. Use for personal contacts, contact groups, and other contacts, with directory lookup also available; use gog-people for the caller profile or Workspace directory profiles."
---

# Google Contacts
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-docs/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-docs
description: "Google Docs operations through gog."
description: "Google Docs through gog. Use for Google Docs text, formatting, tabs, comments, and document exports."
---

# Google Docs
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-drive/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-drive
description: "Google Drive operations through gog."
description: "Google Drive through gog. Use for Drive file search, uploads, downloads, sharing, folders, and metadata; use gog-drive-audit for a sharing audit."
---

# Google Drive
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-forms/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-forms
description: "Google Forms operations through gog."
description: "Google Forms through gog. Use for Google Forms structure, questions, responses, and watches."
---

# Google Forms
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-gmail/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-gmail
description: "Gmail operations through gog."
description: "Gmail through gog. Use for Gmail search, messages, threads, drafts, sending, labels, filters, and settings; use gog-inbox-triage for inbox review or gog-save-attachments for attachment archival."
---

# Gmail
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-groups/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-groups
description: "Google Groups operations through gog."
description: "Google Groups through gog. Use for listing Cloud Identity groups and members; use gog-admin to manage Workspace Admin Directory groups."
---

# Google Groups
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-keep/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-keep
description: "Google Keep operations through gog."
description: "Google Keep through gog. Use for Google Keep notes and attachments."
---

# Google Keep
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-maps/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-maps
description: "Google Maps operations through gog."
description: "Google Maps through gog. Use for Maps place search, place details, directions, and geocoding."
---

# Google Maps
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-meet/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-meet
description: "Google Meet operations through gog."
description: "Google Meet through gog. Use for Google Meet spaces, configuration, call history, and participants."
---

# Google Meet
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-people/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-people
description: "Google People operations through gog."
description: "Google People through gog. Use for the caller profile, a person profile, or Workspace directory search; use gog-contacts to manage personal contacts and contact groups."
---

# Google People
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-photos/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-photos
description: "Google Photos operations through gog."
description: "Google Photos through gog. Use for Google Photos media and albums available to the app, including uploads and the picker."
---

# Google Photos
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-searchconsole/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-searchconsole
description: "Google Search Console operations through gog."
description: "Google Search Console through gog. Use for Search Console sites, search analytics, sitemaps, and URL inspection."
---

# Google Search Console
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-sheets/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-sheets
description: "Google Sheets operations through gog."
description: "Google Sheets through gog. Use for spreadsheet cells, formulas, formatting, notes, validation, and sheet structure."
---

# Google Sheets
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-sites/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-sites
description: "Google Sites operations through gog."
description: "Google Sites through gog. Use for finding Google Sites in Drive, reading site metadata, and printing editor URLs; use gog-drive for file sharing."
---

# Google Sites
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-slides/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-slides
description: "Google Slides operations through gog."
description: "Google Slides through gog. Use for presentations, slides, text, images, speaker notes, and exports."
---

# Google Slides
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-tasks/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-tasks
description: "Google Tasks operations through gog."
description: "Google Tasks through gog. Use for Google Tasks lists, task creation, updates, completion, and materialized repeats."
---

# Google Tasks
Expand Down
2 changes: 1 addition & 1 deletion .agents/skills/gog-youtube/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog-youtube
description: "YouTube operations through gog."
description: "YouTube through gog. Use for YouTube search, videos, channels, activities, comments, playlists, and subscriptions."
---

# YouTube
Expand Down
7 changes: 4 additions & 3 deletions .agents/skills/gog/SKILL.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
name: gog
description: "gog CLI: safe Google Workspace automation, JSON, auth, scoped reads/writes."
description: "Use the gog CLI when Google connectors lack an operation, shell automation needs stable JSON, or local Google auth needs inspection. Shared account, auth, output, and safety guidance for all gog service skills."
---

# gog
Expand Down Expand Up @@ -142,8 +142,9 @@ the pane width. A truncated consent URL does not fail loudly: Google renders
client misconfiguration and sends you debugging the wrong thing. Verify the
captured URL contains `response_type` before using it.

Write the URL to a mode-0600 file and hand it to the browser by file reference
(see `$browser-use`); never echo it. Appending `&login_hint=user@example.com`
Write the URL to a mode-0600 file and use a browser automation tool that can
read that file and open the consent URL without displaying it in logs; never
echo it. Appending `&login_hint=user@example.com`
skips the account chooser and removes a whole class of wrong-account risk.

Expect up to two interstitials when the OAuth client is unverified or in
Expand Down
13 changes: 13 additions & 0 deletions CHANGELOG.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,19 @@

## 0.48.1 - Unreleased

- Calendar: reject empty or inverted RFC3339 free/busy windows, resolve calendar names containing `@` consistently, and reject malformed nonblank attendee clears. (#1328, #1329, #1330) — thanks @privatenumber and @pkyIntelligence.
- Calendar: read search and team event pages up to `--max`, truncate the parent series for future-instance updates, and warn about unavailable free/busy calendars with stable row ordering. (#1311, #1317, #1322) — thanks @saariuslystoned.
- Gmail: exclude all send-as aliases from reply-all and default auto-replies; stop default auto-replies when alias discovery fails, and preserve Cc-only reply-all recipients. (#1318, #1325) — thanks @saariuslystoned.
- Gmail: forward HTML-only originals in the plain-text part and read every watch history page before advancing the cursor. (#1312, #1321) — thanks @saariuslystoned.
- Sheets: preserve numeric JSON tokens in append requests and keep multiline cells on one line in text output. (#1316, #1331) — thanks @saariuslystoned and @pkyIntelligence.
- Output: return empty arrays for Drive labels, Drive/Docs comments, and Sheets notes and links, including `--results-only`. (#1314, #1326) — thanks @saariuslystoned.
- Drive: accept commas in label field flags and download or export a shortcut's target. (#1315, #1319) — thanks @saariuslystoned.
- Tasks: send explicit empty titles and notes when clearing them, and reject an empty status. (#1313) — thanks @saariuslystoned.
- Contacts: document and apply Google's 30-result search ceiling, warning when a larger limit is requested. (#1323) — thanks @saariuslystoned.
- AdSense: show report warnings and truncation hints on stderr in table output. (#1324) — thanks @saariuslystoned.
- Sites: preserve requested false booleans in site metadata JSON. (#1308) — thanks @SebTardif.
- Agent skills: describe when to use each service and distinguish overlapping workflows; explain browser consent without requiring an unshipped skill. (#1335) — thanks @henkisdabro.

- Docs: use placeholder accounts in Gmail auto-reply, Drive audit, and live-testing examples. (#1332) — thanks @vyctorbrzezowski.

## 0.48.0 - 2026-11-05
Expand Down
2 changes: 1 addition & 1 deletion docs/commands/gog-contacts-other-search.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ gog contacts (contact) other search <query> ... [flags]
| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. |
| `--home` | `string` | | Override gogcli config/data/state/cache root (equivalent to GOG_HOME) |
| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
| `--max`<br>`--limit` | `int64` | 50 | Max results |
| `--max`<br>`--limit` | `int64` | 30 | Max results (Google returns at most 30) |
| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) |
| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
| `--quota-project` | `string` | | Google Cloud project to bill for API usage (sent as X-Goog-User-Project; some APIs require it with --access-token or ADC) |
Expand Down
2 changes: 1 addition & 1 deletion docs/commands/gog-contacts-search.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ gog contacts (contact) search <query> ... [flags]
| `-h`<br>`--help` | `kong.helpFlag` | | Show context-sensitive help. |
| `--home` | `string` | | Override gogcli config/data/state/cache root (equivalent to GOG_HOME) |
| `-j`<br>`--json`<br>`--machine` | `bool` | false | Output JSON to stdout (best for scripting) |
| `--max`<br>`--limit` | `int64` | 50 | Max results |
| `--max`<br>`--limit` | `int64` | 30 | Max results (Google returns at most 30) |
| `--no-input`<br>`--non-interactive`<br>`--noninteractive` | `bool` | | Never prompt; fail instead (useful for CI) |
| `-p`<br>`--plain`<br>`--tsv` | `bool` | false | Output stable, parseable text to stdout (TSV; no colors) |
| `--quota-project` | `string` | | Google Cloud project to bill for API usage (sent as X-Goog-User-Project; some APIs require it with --access-token or ADC) |
Expand Down
2 changes: 1 addition & 1 deletion docs/commands/gog-tasks-update.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ gog tasks (task) update (edit,set) <tasklistId> <taskId> [flags]
| `--readonly` | `bool` | false | Block mutating API requests at runtime; auth add also requests read-only OAuth scopes |
| `--results-only` | `bool` | | In JSON mode, emit only the primary result (drops envelope fields like nextPageToken) |
| `--select`<br>`--pick`<br>`--project` | `string` | | In JSON mode, select comma-separated fields (best-effort; supports dot paths). Desire path: use --fields for most commands. |
| `--status` | `string` | | New status: needsAction\|completed (set empty to clear) |
| `--status` | `string` | | New status: needsAction\|completed |
| `--title` | `string` | | New title (set empty to clear) |
| `-v`<br>`--verbose` | `bool` | | Enable verbose logging |
| `--version` | `kong.VersionFlag` | | Print version and exit |
Expand Down
10 changes: 10 additions & 0 deletions docs/examples.md
Original file line number Diff line number Diff line change
Expand Up @@ -27,6 +27,11 @@ permanent deletion is intentional.

## Calendar

`calendar freebusy` rejects empty or inverted windows before querying Google,
including RFC3339 bounds. Calendar names containing `@` resolve as names,
while email-form IDs and `primary` can be queried directly. For event updates,
an empty `--attendees` clears the list; nonblank input must contain an attendee.

See the [`gog calendar`](commands/gog-calendar.md) reference and
[Zoom setup](zoom-auth-setup.md).

Expand Down Expand Up @@ -215,6 +220,11 @@ gog docs raw <docId> --pretty

## Sheets

`sheets append --values-json` preserves numeric tokens in its outgoing request;
Google Sheets still applies its own storage precision. Use JSON output to
preserve cell content exactly. Text and `--plain` output keep each row on one
line, displaying embedded newlines as `\n` and tabs as spaces.

See [batch updates](sheets-batch-update.md), [tables](sheets-tables.md), and
[formatting](sheets-formatting.md).

Expand Down
2 changes: 2 additions & 0 deletions docs/gmail-autoreply.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,3 +44,5 @@ If you cannot use GitHub or are unsure which repo is affected, reply to this ema
- It sends replies in-thread with `In-Reply-To` and `References`.
- It adds `Auto-Submitted: auto-replied` and suppresses common auto-response loops.
- By default it skips bulk/list/auto-generated mail.
- It also skips mail from your account or any send-as alias, even if the message has an external `Reply-To`. Use `--allow-self` to allow those replies.
- Without `--allow-self`, a failed send-as lookup stops the run before searching or sending, so an unavailable alias list cannot cause replies to your own addresses.
3 changes: 3 additions & 0 deletions docs/watch.md
Original file line number Diff line number Diff line change
Expand Up @@ -105,6 +105,9 @@ Notes:
- `watch renew` reuses stored topic/labels.
- Push and pull inspect notifications whose history ID equals the saved cursor;
lower IDs remain stale. Duplicate Pub/Sub message IDs are still ignored.
- Push and pull read every page of Gmail history after the saved cursor and
advance the cursor only after the last page, so bursts of more than one page
of changes are delivered instead of skipped.
- `watch stop` calls Gmail stop + clears state.
- `watch serve` and `watch pull` use stored hook config if `--hook-url` is not
provided.
Expand Down
Loading
Loading