--- id: sm-gog-cli name: "gog-cli" url: https://skills.yangsir.net/skill/sm-gog-cli author: intellectronica domain: game-dev tags: ["gog.com", "cli-tools", "game-management", "gaming-platform"] install_count: 511 rating: 4.20 (29 reviews) github: https://github.com/intellectronica/agent-skills --- # gog-cli > 提供GOG命令行工具的详细使用指南，帮助用户管理游戏库、下载和更新游戏，提升效率。 **Stats**: 511 installs · 4.2/5 (29 reviews) ## Before / After 对比 ### Google Workspace命令行管理 ## Readme # gogcli (gog) CLI A fast, script-friendly CLI for Google Workspace services with JSON-first output and multi-account support. **Repository**: https://github.com/steipete/gogcli ## Prerequisites This skill assumes `gog` is installed and authorised. If commands fail with authentication errors, inform the user they need to: 1. **Install gog**: `brew install steipete/tap/gogcli` 2. **Store OAuth credentials**: `gog auth credentials ` 3. **Add account**: `gog auth add user@gmail.com --services all` Do not attempt to resolve authentication issues automatically. Provide the user with the relevant command and let them handle it. ## Supported Services Gmail, Calendar, Drive, Docs, Sheets, Slides, Chat (Workspace), Classroom, Contacts, Tasks, People, Groups (Workspace), Keep (Workspace, service account only). ## Quick Reference ### Global Flags ```bash --account # Select account --client # Select OAuth client --json # JSON output --plain # TSV output (for scripting) --force # Skip confirmations --no-input # Fail instead of prompting ``` ### Common Patterns ```bash gog --account work@example.com gmail search "is:unread" # Use specific account gog gmail search "is:unread" --json | jq '.threads[].id' # JSON for parsing gog gmail search "is:unread" --plain | cut -f1 # Plain for shell gog gmail search "is:unread" --max 10 --page # Pagination ``` ## Gmail ### Search and Read ```bash gog gmail search "is:unread from:boss@example.com newer_than:7d" gog gmail messages search "is:unread" --include-body gog gmail thread get gog gmail get --format full ``` ### Send Email ```bash # Basic send gog gmail send --to user@example.com --subject "Hello" --body "Message" # With HTML and attachments gog gmail send --to user@example.com --subject "Report" \ --body-html "

Report

" --attach ~/report.pdf # Reply gog gmail send --to user@example.com --subject "Re: Original" \ --body "Reply" --reply-to-message-id ``` ### Labels ```bash gog gmail labels list gog gmail labels create "Project/Subproject" gog gmail thread modify --add "Label" --remove INBOX ``` For full Gmail reference including drafts, filters, vacation, delegates, tracking, and watch, see `references/gmail.md`. ## Calendar ### Events ```bash gog calendar events primary --from "2024-12-01" --to "2024-12-31" --weekday gog calendar events primary --query "meeting" # Create event gog calendar create primary --summary "Meeting" \ --from "2024-12-20T14:00:00" --to "2024-12-20T15:00:00" # With attendees and recurrence gog calendar create primary --summary "Weekly Standup" \ --from "2024-12-20T09:00:00" --to "2024-12-20T09:30:00" \ --attendees "alice@example.com,bob@example.com" \ --rrule "FREQ=WEEKLY;BYDAY=MO,WE,FR" # Respond gog calendar respond primary --status accepted ``` ### Special Event Types ```bash gog calendar focus-time create primary --from DT --to DT --auto-decline gog calendar ooo create primary --from DT --to DT --decline-message "Away" gog calendar working-location create primary --from DT --to DT --location home ``` For full Calendar reference, see `references/calendar.md`. ## Drive, Docs, Sheets, Slides ### Drive ```bash gog drive ls --parent gog drive search "quarterly report" gog drive download --out ~/Downloads/ gog drive upload ~/report.pdf --parent gog drive mkdir "New Folder" --parent gog drive share --email user@example.com --role writer ``` ### Sheets ```bash gog sheets read "Sheet1!A1:D10" gog sheets write "Sheet1!A1:B2" --values '[["Name","Age"],["Alice",30]]' gog sheets append "Sheet1!A:B" --values '[["Bob",25]]' gog sheets format "Sheet1!A1:D1" --bold --bg-color "#FFCC00" ``` ### Export ```bash gog docs export --format pdf --out ~/doc.pdf gog slides export --format pptx --out ~/slides.pptx ``` For full Drive/Docs/Sheets/Slides reference, see `references/drive-docs.md`. ## Tasks ```bash gog tasks lists gog tasks list gog tasks add --title "Buy groceries" --due "2024-12-20" gog tasks add --title "Weekly review" --due "2024-12-20" --repeat weekly gog tasks done ``` ## Contacts ```bash gog contacts search "john" gog contacts create --given "John" --family "Doe" --email "john@example.com" gog contacts directory search "smith" # Workspace ``` ## Classroom ```bash gog classroom courses --state ACTIVE gog classroom students gog classroom coursework create --title "Homework" --type ASSIGNMENT --due "2024-12-31T23:59:59Z" gog classroom submissions grade --grade 95 ``` For Classroom, Chat, Contacts, Tasks, People, Groups, Keep, see `references/other-services.md`. ## Configuration ### Config Locations - **macOS**: `~/Library/Application Support/gogcli/config.json` - **Linux**: `~/.config/gogcli/config.json` - **Windows**: `%AppData%\gogcli\config.json` ### Settings ```bash gog config set default_timezone America/New_York gog config set default_account user@gmail.com gog config list ``` ### Environment Variables ```bash GOG_ACCOUNT=user@gmail.com # Default account GOG_CLIENT=work # OAuth client GOG_JSON=1 # Default JSON output GOG_PLAIN=1 # Default plain output GOG_TIMEZONE=America/New_York # Display timezone GOG_ENABLE_COMMANDS=calendar,tasks # Command allowlist ``` For full configuration, see `references/configuration.md`. ## Multi-Account Usage ```bash gog --account work@example.com gmail search "is:unread" gog auth alias set work work@example.com gog --account work gmail search "is:unread" gog auth list --check ``` For authentication including service accounts, see `references/authentication.md`. ## Scripting ```bash # JSON processing gog gmail search "is:unread" --json | jq -r '.threads[].id' # Batch operations gog gmail search "older_than:30d" --json | \ jq -r '.threads[].id' | \ xargs -I {} gog gmail thread modify {} --add Archive --remove INBOX # Non-interactive gog gmail send --to user@example.com --subject "Test" --body "Hi" --force ``` ## Troubleshooting If commands fail, inform the user of the likely cause: | Error | Cause | Solution | |-------|-------|----------| | `no credentials` | OAuth not configured | `gog auth credentials ` | | `token expired` | Auth invalid | `gog auth add --force-consent` | | `insufficient scope` | Missing permissions | `gog auth add --services ` | | `command not found` | Not installed | `brew install steipete/tap/gogcli` | Status checks: ```bash gog auth list --check gog auth status ``` ## Reference Files - `references/command-reference.md` - Complete command specification - `references/authentication.md` - Auth, credentials, multi-account - `references/configuration.md` - Config and environment variables - `references/gmail.md` - Gmail operations - `references/calendar.md` - Calendar operations - `references/drive-docs.md` - Drive, Docs, Sheets, Slides - `references/other-services.md` - Classroom, Chat, Contacts, Tasks, People, Groups, Keep --- *Source: https://skills.yangsir.net/skill/sm-gog-cli* *Markdown mirror: https://skills.yangsir.net/api/skill/sm-gog-cli/markdown*