# Bishwashere Cowcode Gog

> gog

- Skill: `tomevault-io/bishwashere-cowcode-gog` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/bishwashere-cowcode-gog`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/bishwashere-cowcode-gog/raw
- Safety review: pending (external: skill-scanner PASS, skillspector CAUTION)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/bishwashere-cowcode-gog

---


# gog

Use `gog` to access Gmail, Calendar, Drive, Contacts, Sheets, and Docs.

Call `run_skill` with:
- skill: "gog"
- arguments.action: "run"
- arguments.argv: array of command parts (do not include `gog`)

Always use:
--json
--no-input

Never fabricate tool output.

---

## Arguments

- action: must be exactly "run"
- argv: array of strings for the gog command
- account: optional
- confirm: required for gmail send or calendar create/add/insert

Example:
["gmail","search","newer_than:14d","--max","20000","--json","--no-input"]

Use --max 10000 or 20000 when you need to analyze or count over many messages; the CLI does not support page tokens, so one large batch is the way to get more results.

---

## Gmail Behavior Policy

Default mail scope:
- Use All Mail
- Exclude Sent
- Do not ask for scope clarification unless explicitly requested

Result retrieval:
- The gog CLI does **not** support --page-token or pagination. Use a single call with a large --max (e.g. 10000 or 20000) when analysis or counting is required.
- **Always answer from the data returned.** If gog returns messages/results, compute and report the answer (e.g. "top sender in the last 14 days: X with N emails"). Do not refuse to answer or say you "can't" when you have usable data.
- Only mention truncation if the result count equals --max (e.g. "Based on the first 5000 messages…"). One short sentence is enough; then give the answer.
- Do not offer "Option A / Option B" or ask the user to choose when you already have a result. Give the answer first; optionally add one line like "This is from the first N messages; gog does not support pagination for more."

Do not refuse execution solely due to pagination or nextPageToken.

---

## Execution Principles

- Prefer single decisive tool call when possible
- Do not negotiate default behavior
- Do not offer UI alternatives unless tool execution fails
- **Provide the computed answer directly.** Never respond with "I can't" or "Which option do you want?" when the tool returned data-answer from that data.
- Be concise and decisive

## Tool schema

```tool-schema
gog_run
  description: Run a gog CLI command. Pass argv as array (e.g. gmail search, calendar list). Use --json and --no-input.
  parameters:
    argv: array
    account: string
    confirm: boolean
```

---
> Source: [bishwashere/cowcode](https://github.com/bishwashere/cowcode) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-07-09 -->