Releases: steipete/gogcli
Releases · steipete/gogcli
v0.13.0
0.13.0
Highlights
- Gmail: safer sending and richer message workflows, with no-send guardrails, forwarding, autoreplies, full-body search output, label styling, and better MIME/body handling. (#454, #482, #447, #457, #476, #477, #511) — thanks @veteranbv, @spencer-c-reed, @GodsBoy, @iskw9973, @shashankkr9, @yeager, and @dinakars777.
- Drive/Docs/Slides: smoother content round-trips with Markdown-to-Docs upload conversion, restored Markdown replace writes, rendered slide thumbnails, commenter sharing, and better Docs sed formatting. (#487, #501, #498, #443, #483) — thanks @johnbenjaminlewis, @twilsher, @gianpaj, @pavelzak, and @bill492.
- Sheets: chart management lands, including list/inspect/create/update/delete and a chart-range fix for sheet ID 0. (#434) — thanks @andybergon.
- Calendar: create secondary calendars and get more predictable timezone/day-bound behavior. (#455, #492, #509, #510) — thanks @alexknowshtml, @RaphaelRUzan, and @dinakars777.
- Auth and agent safety: credential cleanup, Google Ads auth, keyring namespace overrides, command denylists, and safer send-operation controls. (#473, #264, #463, #218, #173, #454) — thanks @yamagucci, @ufkhan97, @mkurz, @EricYangTL, @spookyuser, and @veteranbv.
Added
- Gmail: add
--gmail-no-send,GOG_GMAIL_NO_SEND,gmail_no_send, and per-accountconfig no-sendguards for blocking send operations. (#454) — thanks @veteranbv. - Gmail: add
gmail forward/gmail fwdto forward a message with optional note, verified send-as alias, and original attachments. (#482) — thanks @spencer-c-reed. - Gmail: add
gmail autoreplyto reply once to matching messages, label the thread for dedupe, and optionally archive/mark read. - Gmail: add
gmail messages search --fullto print complete message bodies instead of truncating text output. (#447) — thanks @GodsBoy. - Gmail: add
gmail labels styleto update user label colors and list/message visibility. (#457) — thanks @iskw9973. - Drive: convert Markdown uploads to Google Docs and strip leading YAML frontmatter by default, with
--keep-frontmatterto opt out. (#487) — thanks @johnbenjaminlewis. - Drive: allow
drive share --role commenterfor comment-only sharing. (#443) — thanks @pavelzak. - Drive: show owner email in
drive lsanddrive searchtable output. (#458) — thanks @laihenyi. - Slides: add
slides thumbnail/slides thumbto fetch rendered slide thumbnail URLs or download PNG/JPEG images. (#498) — thanks @gianpaj. - Sheets: add
sheets chartto list, inspect, create, update, and delete embedded charts. (#434) — thanks @andybergon. - Sheets: add
add-sheet,rename-sheet, anddelete-sheettab aliases plussheets add-tab --index. (#442) — thanks @alexknowshtml. - Calendar: add
calendar create-calendar/new-calendarto create secondary calendars with description, timezone, and location. (#455) — thanks @alexknowshtml. - Auth: add
auth credentials removeto delete stored OAuth client credentials and associated refresh tokens. (#473) — thanks @yamagucci. - Auth: add
adsas an auth service for Google Ads API tokens. (#264) — thanks @ufkhan97. - Secrets: allow
GOG_KEYRING_SERVICE_NAMEto override the keyring namespace. (#463) — thanks @mkurz. - Agent safety: allow dotted command paths in
--enable-commandsand add--disable-commands/GOG_DISABLE_COMMANDSdenylist support. (#218, #173) — thanks @EricYangTL and @spookyuser. - Contacts: add
--gendertocontacts createandcontacts update, and include gender incontacts gettext output. (#438) — thanks @klodr. - Chat: make
chat spaces finduse case-insensitive substring matching by default, with--exactfor legacy exact lookup. (#506) — thanks @mvanhorn.
Fixed
- Calendar: avoid ambiguous timezone guessing from offset-only event times, preserve timezones for focus-time events, and use exclusive next-midnight bounds for full-day ranges. (#492, #509, #510) — thanks @RaphaelRUzan and @dinakars777.
- Gmail: preserve sent and received body content by using quoted-printable plain text, non-
7bitnon-ASCII HTML, and safer UTF-8 charset handling. (#476, #477, #511) — thanks @shashankkr9, @yeager, and @dinakars777. - Docs: restore
docs write --replace --markdownconversion and preserve sed formatting ranges, UTF-16 offsets, and&whole-match replacements. (#501, #483) — thanks @twilsher and @bill492. - Sheets: preserve valid chart ranges that target sheet ID 0 while still remapping sample-style zero IDs when the spreadsheet has no zero-ID sheet. (#434) — thanks @andybergon.
- Auth: remove stale aliases and account-client mappings from config when
auth removedeletes an account. (#467) — thanks @mvanhorn. - Contacts: reject all individual update flags when
contacts update --from-fileis used. (#439) — thanks @klodr. - Tasks: clear task due dates when
tasks update --due=is provided. (#507) — thanks @dinakars777. - CLI: generate native zsh completions without relying on
bashcompinit. (#481) — thanks @piiq. - Windows: expand
~\...paths and run the integration live-test wrapper through PowerShell. (#452) — thanks @gagradebnath. - Tracking: prefer file-stored tracking secrets over stale keyring values unless keyring storage is configured. (#469) — thanks @alexuser.
- Time parsing: accept
tues,thur, andthursas weekday expressions. (#440) — thanks @sjhddh.
v0.12.0
0.12.0
Highlights
- Admin: full Workspace Admin users/groups coverage for common directory operations. (#403) — thanks @dl-alexandre.
- Auth: new headless/cloud auth paths with ADC, direct access tokens, custom callbacks, proxy-safe loopback settings, and extra-scope controls. (#357, #419, #227, #398, #421) — thanks @tengis617, @mmkal, @cyberfox, @salmonumbrella, and @peteradams2026.
- Docs: much stronger document editing and export flow with tab targeting, richer find-replace, pageless mode, and native Markdown/HTML export. (#330, #305, #300, #282, #141) — thanks @ignacioreyna, @chparsons, @shohei-majima, @fprochazka, and @in-liberty420.
- Sheets: spreadsheet editing/formatting expands significantly with named ranges, tab management, notes, find-replace, formatting controls, inserts, links, and format inspection. (#278, #309, #430, #341, #320, #203, #374, #284) — thanks @TheCrazyLex, @JulienMalige, @andybergon, @Shehryar, @omothm, and @nilzzzzzz.
- Calendar: aliases, subscribe, and selector parity make multi-calendar workflows much easier. (#393, #327, #319) — thanks @salmonumbrella and @cdthompson.
- Forms/Slides/Keep: forms management + watches, slides from templates, and first write/delete coverage for Keep. (#274, #273, #413) — thanks @alexknowshtml, @penguinco, and @jgwesterlund.
Added
- Admin: add Workspace Admin Directory commands for users and groups, including user list/get/create/suspend and group membership list/add/remove. (#403) — thanks @dl-alexandre.
- Auth: add Application Default Credentials mode via
GOG_AUTH_MODE=adcfor Workload Identity, Cloud Run, and localgcloudADC flows without stored OAuth refresh tokens. (#357) — thanks @tengis617. - Auth: add
--access-token/GOG_ACCESS_TOKENfor direct access-token auth in headless or CI flows, bypassing stored refresh tokens. (#419) — thanks @mmkal. - Auth: add
auth add|manage --listen-addrplus--redirect-hostfor browser OAuth behind proxies or remote loopback forwarding. (#227) — thanks @cyberfox. - Auth: add
auth add --redirect-urifor manual/remote OAuth flows, so custom callback hosts can be reused across the printed auth URL, state cache, and code exchange. (#398) — thanks @salmonumbrella. - Auth: add
--extra-scopestoauth addfor appending custom OAuth scope URIs beyond the built-in service scopes. (#421) — thanks @peteradams2026. - Docs: add
--tab-idto editing commands so write/update/insert/delete/find-replace can target a specific Google Docs tab. (#330) — thanks @ignacioreyna. - Docs: extend
docs find-replacewith--first,--content-file, Markdown replacement, inline image insertion, and image sizing syntax. (#305) — thanks @chparsons. - Docs: add
--pagelesstodocs create,docs write, anddocs updateto switch documents into pageless mode after writes. (#300) — thanks @shohei-majima. - Docs: add native Google Docs Markdown export via
docs export --format md. (#282) — thanks @fprochazka. - Docs: add native Google Docs HTML export via
docs export --format html. (#141) — thanks @in-liberty420. - Sheets: add named range management (
sheets named-ranges) and let range-based Sheets commands accept named range names where GridRange-backed operations are needed. (#278) — thanks @TheCrazyLex. - Sheets: add
add-tab,rename-tab, anddelete-tabcommands for managing spreadsheet tabs, with delete dry-run/confirmation guardrails. (#309) — thanks @JulienMalige. - Sheets: add
merge,unmerge,number-format,freeze,resize-columns, andresize-rowscommands for spreadsheet layout/format control. (#320) — thanks @Shehryar. - Sheets: add
sheets update-note/set-noteto write or clear cell notes across a range. (#430) — thanks @andybergon. - Sheets: add
sheets find-replaceto replace text across a spreadsheet or a specific tab, with exact-match, regex, and formula search options. (#341) — thanks @Shehryar. - Sheets: add
sheets insertto insert rows/columns into a sheet. (#203) — thanks @andybergon. - Sheets: add
sheets create --parentto place new spreadsheets in a Drive folder. (#424) — thanks @ManManavadaria. - Sheets: add
sheets read-formatto inspectuserEnteredFormat/effectiveFormatper cell. (#284) — thanks @nilzzzzzz. - Sheets: add
sheets links(aliashyperlinks) to list cell links from ranges, including rich-text links. (#374) — thanks @omothm. - Forms: add form update/question-management commands plus response watch create/list/delete/renew, with delete-question validation and confirmation guardrails. (#274) — thanks @alexknowshtml.
- Slides: add
create-from-templatewith--replace/--replacements, dry-run support, and template placeholder replacement stats. (#273) — thanks @penguinco. - Calendar: add
calendar alias list|set|unset, and let calendar commands resolve configured aliases before API/name lookup. (#393) — thanks @salmonumbrella. - Calendar: let
calendar freebusy/calendar conflictsaccept--cal, names, indices, and--alllikecalendar events. (#319) — thanks @salmonumbrella. - Calendar: add
calendar subscribe(aliasessub,add-calendar) to add a shared calendar to the current account’s calendar list. (#327) — thanks @cdthompson. - Gmail: add
watch serve --history-typesfiltering (messageAdded|messageDeleted|labelAdded|labelRemoved) and includedeletedMessageIdsin webhook payloads. (#168) — thanks @salmonumbrella. - Gmail: add
gmail labels renameto rename user labels by ID or exact name, with system-label guards and wrong-case ID safety. (#391) — thanks @adam-zethraeus. - Gmail: add
gmail messages modifyfor single-message label changes, complementing thread- and batch-level modify flows. (#281) — thanks @zerone0x. - Gmail: add
gmail filters exportto dump filter definitions as JSON to stdout or a file for backup/script workflows. (#119) — thanks @Jeswang. - Keep: add
keep createfor text/checklist notes andkeep deletefor note removal. (#413) — thanks @jgwesterlund. - Contacts: support
--org,--title,--url,--note, and--customon create/update; include custom fields in get output with deterministic ordering. (#199) — thanks @phuctm97. - Contacts: add
--relation type=personto contact create/update, include relations in textcontacts get, and cover relation payload updates. (#351) — thanks @karbassi. - Contacts: add
--addressto contact create/update and include addresses in textcontacts get. (#148) — thanks @beezly. - Drive: add
drive ls --all(alias--global) to list across all accessible files; make--alland--parentmutually exclusive. (#107) — thanks @struong. - Chat: add
chat messages reactions create|list|deleteto manage emoji reactions on messages;chat messages react <message> <emoji>as a shorthand for creating reactions;reactionis an alias forreactions. (#426) — thanks @fernandopps. - Tasks: add
--recur/--recur-rrulealiases for repeat materialization, including RRULEINTERVALsupport for generated occurrences. (#408) — thanks @salmonumbrella.
Fixed
- Google API: use transport-level response-header timeouts for API clients while keeping token exchanges bounded, so large downloads are not cut short by
http.Client.Timeout. (#425) — thanks @laihenyi. - Timezone: embed the IANA timezone database so Windows builds can resolve calendar timezones correctly. (#388) — thanks @visionik.
- Auth: persist rotated OAuth refresh tokens returned during API calls so later commands keep working without re-auth. (#373) — thanks @joshp123.
- Auth: allow pure service-account mode when the configured subject matches the service account itself, instead of forcing domain-wide delegation impersonation. (#399) — thanks @carrotRakko.
- Auth: keep Keep-only service-account fallback isolated to Keep commands so other Google services do not accidentally pick it up. (#414) — thanks @jgwesterlund.
- Auth: add
--gmail-scope full|readonly, and disableinclude_granted_scopesfor readonly/limited auth requests to avoid Drive/Gmail scope accumulation. (#113) — thanks @salmonumbrella. - Auth: preserve scope-shaping flags in the remote step-2 replay guidance for
auth add --remote. (#427) — thanks @doodaaatimmy-creator. - Calendar: preserve full RRULE values and recurring-event timezones during updates so recurrence edits don’t lose BYDAY lists or hit missing-timezone API errors. (#392) — thanks @salmonumbrella.
- Calendar: let recurring
calendar update --scope=futureandcalendar delete --scope=futurestart from an instance event ID by resolving the parent series first. (#319) — thanks @salmonumbrella. - Calendar: use
Calendars.Getfor timezone lookups so service-account flows don’t 404 oncalendarList/primary. (#325) — thanks @markwatson. - Calendar: hide cancelled/deleted events from
calendar eventslist output by explicitly settingshowDeleted=false. (#362) — thanks @sharukh010. - Calendar: reject ambiguous calendar-name selectors for
calendar eventsinstead of guessing. (#131) — thanks @salmonumbrella. - Calendar: respond patches only attendees to avoid custom reminders validation errors. (#265) — thanks @sebasrodriguez.
- Calendar: force-send
minutes=0for--reminder popup:0mso zero-minute popup reminders survive Google Calendar API JSON omission rules. (#316) — thanks @salmonumbrella. - Calendar: clarify that RFC3339
--from/--totimestamps must include a timezone while keeping date and relative-time help intact. (#409) — thanks @dbhurley. - Gmail: add a fetch delay in
watch serveso History API reads don't race message indexing. (#397) — thanks @salmonumbrella. - Gmail: preserve the selected
--clientduringwatch servepush handling instead of falling back to the default client. (#411) — thanks @chrysb. - Gmail: allow Workspace-managed send-as aliases with empty verification status in
sendanddrafts create. (#407) — thanks @salmonumbrella. - Gmail: fall back to
MimeTypecharset hints whenContent-Typeheaders are missing s...
v0.11.0
0.11.0
Added
- Apps Script: add
appscriptcommand group (create/get projects, fetch content, run deployed functions). - Forms: add
formscommand group (create/get forms, list/get responses). - Docs: add
docs commentsfor listing and managing Google Doc comments. (#263) — thanks @alextnetto. - Sheets: add
sheets notesto read cell notes. (#208) — thanks @andybergon. - Gmail: add
gmail send --quoteto include quoted original message in replies. (#169) — thanks @terry-li-hm. - Drive: add
drive ls|search --no-all-drivesto restrict queries to "My Drive" for faster/narrower results. (#258) - Contacts: update contacts from JSON via
contacts update --from-file(PR #200 — thanks @jrossi).
Fixed
- Drive: make
drive deletemove files to trash by default; add--permanentfor irreversible deletion. (#262) — thanks @laihenyi. - Drive/Gmail: pass through Drive API filter queries in
drive search; RFC 2047-encode non-ASCII display names in mail headers (From/To/Cc/Bcc/Reply-To). (#260) — thanks @salmonumbrella. - Calendar: allow opting into attendee notifications for updates and cancellations via
calendar update|delete --send-updates all|externalOnly|none. (#163) — thanks @tonimelisma. - Calendar: fall back to fixed-offset timezones (
Etc/GMT±N) for recurring events when given RFC3339 offset datetimes; harden Gmail attachment output paths and cache validation; honor proxy defaults for Google API transports. (#228) — thanks @salmonumbrella. - Auth: manual OAuth flow uses an ephemeral loopback redirect port (avoids unsafe/privileged ports in browsers). (#172) — thanks @spookyuser.
- Gmail: include primary display name in
gmail sendFrom header when using service account impersonation (domain-wide delegation). (#184) — thanks @salmonumbrella. - Gmail: when
gmail attachment --outpoints to a directory (or ends with a trailing slash), combine with--nameand avoid false cache hits on directories. (#248) — thanks @zerone0x. - Drive: include shared drives in
drive lsanddrive search; rejectdrive download --formatfor non-Google Workspace files. (#256) — thanks @salmonumbrella. - Drive: validate
drive download --formatvalues and error early for unknown formats. (#259)
v0.10.0
0.10.0
Added
- Docs/Slides: add
docs updatemarkdown formatting + table insertion, plus markdown-driven slides creation and template-based slide creation. (#219) — thanks @maxceem. - Slides: add add-slide/list-slides/delete-slide/read-slide/update-notes/replace-slide for image decks, including --before insertion and --notes '' clear behavior. (#214) — thanks @chrismdp.
- Docs: add tab support (
docs list-tabs,docs cat --tab,docs cat --all-tabs) and editing commands (docs write|insert|delete|find-replace). (#225) — thanks @alexknowshtml. - Docs: add
docs create --fileto import Markdown into Google Docs with inline image support and hardened temp-file cleanup. (#244) — thanks @maxceem. - Drive: add
drive upload --replaceto update files in-place (preservesfileId/shared link). (#232) — thanks @salmonumbrella. - Drive: add upload conversion flags
--convert(auto) and--convert-to(doc|sheet|slides). (#240) — thanks @Danielkweber. - Drive: share files with an entire Workspace domain via
drive share --to domain. (#192) — thanks @Danielkweber. - Gmail: add
--exclude-labelstowatch serve(defaults:SPAM,TRASH). (#194) — thanks @salmonumbrella. - Gmail: add
gmail labels delete <labelIdOrName>with confirm + system-label guardrails and case-sensitive ID handling. (#231) — thanks @Helmi. - Contacts: support
contacts update --birthdayand--notes; unify shared date parsing and docs. (#233) — thanks @rosssivertsen.
Fixed
- Live tests: make
scripts/live-test.shandscripts/live-chat-test.shCWD-safe (repo-root aware builds and sourcing). - Calendar: interpret date-only and relative day
--tovalues as inclusive end-of-day while keeping--to nowas a point-in-time bound. (#204) — thanks @mjaskolski. - Auth: improve remote/server-friendly manual OAuth flow (
auth add --remote). (#187) — thanks @salmonumbrella. - Gmail: avoid false quoted-printable detection for already-decoded URLs with uppercase hex-like tokens while still decoding unambiguous markers (
=3D, chained escapes, soft breaks). (#186) — thanks @100menotu001. - Sheets: preserve TSV tab delimiters for
sheets get --plainoutput. (#212) — thanks @salmonumbrella. - CLI: land PR #201 with conflict-resolution fixes for
--fieldsrewrite, calendar--allpaging, schema command-path parsing, and case-sensitive Gmail watch exclude-label IDs. (#201) — thanks @salmonumbrella. - Secrets: set keyring item labels to
gogcliso macOS security prompts show a clear item name. (#106) — thanks @maxceem.
v0.9.0
0.9.0 - 2026-01-22
Highlights
- Auth: multi-org login with per-client OAuth credentials + token isolation. (#96)
Added
- Calendar: show event timezone and local times; add --weekday output. (#92) — thanks @salmonumbrella.
- Gmail: show thread message count in search output. (#99) — thanks @jeanregisser.
- Gmail: message-level search with optional body decoding. (#88) — thanks @mbelinky.
Fixed
- Auth: fix Gmail search example in auth success template. (#89) — thanks @rvben.
- CLI: remove redundant newlines in text output for calendar, chat, Gmail, and groups commands. (#91) — thanks @salmonumbrella.
- Gmail: include primary account display name in send From header when available. (#93) — thanks @salmonumbrella.
- Keyring: persist OAuth tokens across Homebrew upgrades. (#94) — thanks @salmonumbrella.
- Docs: update Gmail command examples in README. (#95) — thanks @chrisrodz.
- Contacts: include birthdays in contact get output. (#102) — thanks @salmonumbrella.
- Calendar: force custom reminders payload to send UseDefault=false. (#100) — thanks @salmonumbrella.
- Gmail: add read alias + default thread get. (#103) — thanks @salmonumbrella.
v0.8.0
0.8.0
Added
- Chat: spaces, messages, threads, and DM commands (Workspace only). (#84) — thanks @salmonumbrella.
- People: profile lookup, directory search, and relations commands. (#84) — thanks @salmonumbrella.
Fixed
- Chat: normalize thread IDs and show a clearer error for consumer accounts. (#84)
v0.7.0
0.7.0
Highlights
- Classroom: full command suite (courses, roster, coursework/materials, announcements, topics, invitations, guardians, profiles) plus course URLs. (#73) — thanks @salmonumbrella.
- Calendar: propose-time command and enterprise event types (Focus Time/Out of Office/Working Location). (#75) — thanks @salmonumbrella.
- Gmail: attachment details in
gmail get(humanized sizes + JSON fields). (#83) — thanks @jeanregisser.
Added
- Auth: permission upgrade UI in the account manager + missing service icons. (#73) — thanks @salmonumbrella.
- CLI: auth aliases,
time now,--enable-commandsallowlist, and day-of-week JSON fields. (#75) — thanks @salmonumbrella. - Tasks: repeat schedules +
tasks getcommand. (#75) — thanks @salmonumbrella.
Fixed
- Calendar: propose-time decline sends updates, default events to primary, and improved error guidance. (#75)
- Gmail: resync on stale history 404s and skip missing message fetches without masking non-404 failures. (#70) — thanks @antons.
- Gmail: include
gmail.settings.sharingscope for filter operations to avoid 403 insufficientPermissions. (#69) — thanks @ryanh-ai. - Auth: request Gmail settings scopes so settings commands work reliably.
- Auth: account manager upgrade respects managed services and skips Keep OAuth scopes. (#73) — thanks @salmonumbrella.
- Classroom: normalize assignee updates + fix grade update masks; scan pages when filtering coursework/materials by topic; add leave confirmation. (#73, #74) — thanks @salmonumbrella.
- Tasks: normalize due dates to RFC3339 so date-only inputs work reliably (including repeat).
- Timezone: honor
--timezone localand allow env/config defaults for Gmail + Calendar output. (#79) — thanks @salmonumbrella. - CLI: enable shell completions and stop flag suggestions after
--. (#77) — thanks @salmonumbrella. - Groups: friendlier Cloud Identity errors for consumer accounts and missing scopes.
Build
- Deps: update Go modules and JS worker dev deps; bump pinned dev tools; switch WSL to v5.
Tests
- Live: add
scripts/live-test.shwrapper and expand smoke coverage across services. - Calendar: add integration tests for propose-time.
- Gmail: add attachment output tests for
gmail get. - Classroom: add integration smoke tests and command coverage.
- Drive: expand
drive drivescoverage (formatting + query/paging params). - Auth: use
net.ListenConfig.Listenin tests to satisfy newer lint.
v0.6.1
v0.6.0
0.6.0
Added
- Auth: Workspace service accounts (domain-wide delegation) for all services via
gog auth service-account ...(preferred when configured). (#54) — thanks @pvieito.
Fixed
- Keep: use
keep.readonlyscope (service account). (#64) — thanks @jeremys. - Sheets:
gog auth add --services sheets --readonlynow includes Drive read-only scope sogog sheets exportworks. (#62)
Tests
- Auth: expand scope matrix regression tests for
--readonlyand--drive-scope. (#63)
v0.5.4
Fixed
- Paths: expand leading ~ in user-provided file paths (e.g. --out "~/Downloads/file.pdf"). (#56) — thanks @salmonumbrella.
- Calendar: accept ISO 8601 timezones without colon (e.g. -0800) and add gog calendar list alias. (#56) — thanks @salmonumbrella.