---
name: gog-chat
description: "Google Chat via the gog CLI: list spaces and threads, read messages, send messages and DMs, and add reactions. Use for Chat automation with JSON output. Sending posts real messages — only when the user asked."
---

# gog chat

Chat reads and writes with parseable output. Pick the account on every call with
`--account <email>` (or set `GOG_ACCOUNT`).

## Reads

```bash
gog --account you@example.com chat spaces list --json --wrap-untrusted
gog --account you@example.com chat spaces find --query "team" --json
gog --account you@example.com chat messages list <spaceId> --json --wrap-untrusted
gog --account you@example.com chat threads list <spaceId> --json --wrap-untrusted
```

## Writes (post real messages)

```bash
gog --account you@example.com chat messages send <spaceId> --text "..."
gog --account you@example.com chat dm send <userId> --text "..."
gog --account you@example.com chat messages react <messageId> --emoji 👍
gog --account you@example.com chat spaces create --name "..."
```

## Safety

- `messages send`/`dm send` post to real people — treat like sending mail: do it
  only when the user asked, and confirm the space/user id and content first.
- stdout is data (`--json`/`--plain`); hints go to stderr. `--no-input` in automation.

## Discovery

`gog chat --help` · `gog chat <cmd> --help` · `gog schema chat <cmd> --json`
Reference: <https://gogcli.sh/>
