APP

adom-gchat — Google Chat CLI

Post to Google Chat from any Adom container. Webhook-based, org-customizable. Each org configures their own spaces, then publishes an org-scoped wiki page so their teammates auto-discover it.

adom-gchat — Google Chat CLI
💬 Sample prompts Paste any of these into Claude Code to use this app
Post to chat adom-gchat send --space engineering 'deploy complete'
List spaces adom-gchat spaces
Test message adom-gchat send --space kel --dry-run 'test message'
Set up gchat adom-gchat setup
Install this skill

Paste this into Claude Code (VS Code panel, Adom editor, or terminal) to install:

Fetch the Adom Wiki app "adom-gchat — Google Chat CLI" (slug: adom-gchat) at https://wiki-ufypy5dpx93o.adom.cloud/wiki/apps/adom-gchat. This is a knowledge-only app — no binary. Call GET https://wiki-ufypy5dpx93o.adom.cloud/api/v1/pages/adom-gchat, extract the .page.skill_source field, and save it to ~/.claude/skills/adom-gchat/SKILL.md (create the directory). Then confirm by showing the first 10 lines of the saved file.

adom-gchat — Google Chat CLI

Post messages to Google Chat spaces from any Adom container. Webhook-based, no OAuth needed. Each org customizes it for their own Google Workspace.

Install

curl -fsSL https://wiki-ufypy5dpx93o.adom.cloud/static/apps/adom-gchat/adom-gchat \
  -o /tmp/adom-gchat && chmod +x /tmp/adom-gchat \
  && sudo install -m 0755 /tmp/adom-gchat /usr/local/bin/adom-gchat \
  && adom-gchat install

Usage

# Send a message
adom-gchat send --space engineering "deploy complete, all tests green"

# Preview without posting
adom-gchat send --space engineering --dry-run "does this look right?"

# Threaded reply
adom-gchat send --space engineering --thread deploy-v2 "hotfix landed"

# List configured spaces
adom-gchat spaces

# Check connectivity
adom-gchat health

Setting up for your org

  1. Open your Google Chat space > Settings > Apps & integrations > Webhooks
  2. Create a webhook — name it "Kel", use this avatar URL: https://wiki-ufypy5dpx93o.adom.cloud/static/apps/adom-gchat/kel-avatar.png
  3. Copy the webhook URL Google gives you
  4. Run adom-gchat setup and paste the URL when prompted
  5. Test: adom-gchat send --space <name> --dry-run "hello from our org"
  6. Post for real: adom-gchat send --space <name> "hello world"

Share with your team

Once your org is set up, share it so your teammates get auto-discovery:

adom-gchat publish --org <your-org-name>

This creates an org-scoped wiki page. Your teammates install adom-gchat, and the org config auto-discovers for them — they just type "post to chat" and Claude knows what to do.

How it works

The CLI reads webhook URLs from ~/.config/gchat-webhooks.json and POSTs plain text (with Google Chat markdown) to Google's incoming webhook API. No server, no OAuth, no open ports. The webhook URL is the only credential.

Every message is attributed: *OrgName (on behalf of username)* message.

MD
SKILL.md 9 days ago
Claude Code skill for adom-gchat
v0.1.1: add mandatory preview sectionJohn Lauer · 9 days ago
2.1 KB
ADOM
adom-gchat 9 days ago
Google Chat CLI with preview gate
v0.1.1: enforce preview gate on all posts via --permission-to-post-givenJohn Lauer · 9 days ago
4.6 MB
PNG
kel-avatar.png 18 days ago
Kel bot avatar — use when creating a Google Chat webhook
Kel avatar for webhook setupJohn Lauer · 18 days ago
47.1 KB

AI Skill — how Claude uses this app

Edit AI Skill

name: adom-gchat description: > Post to Google Chat from any Adom container. Webhook-based, org- customizable. Each org configures their own spaces and attribution, then publishes an org-scoped wiki page so their employees auto- discover it. Use the CLI, not raw curl or webhook URLs. Trigger words: gchat, google chat, post to chat, team notification, chat webhook, post to team, send message to space, chat alert, announce to team, notify team, kel, post to kel.

adom-gchat — Google Chat CLI

Post messages to Google Chat spaces from any Adom container. Webhook- based, no OAuth needed. Each org customizes it for their own Google Workspace.

Install

Install adom-gchat. Download from
https://wiki-ufypy5dpx93o.adom.cloud/static/apps/adom-gchat/adom-gchat
→ /tmp/adom-gchat, chmod +x, sudo install to /usr/local/bin/adom-gchat,
then run `adom-gchat install` to deploy the skill + bash completions.
Verify with `adom-gchat spaces`.

Usage

# Send a message
adom-gchat send --space engineering "deploy complete, all tests green"

# Threaded reply
adom-gchat send --space engineering --thread deploy-v2 "hotfix landed"

# List configured spaces
adom-gchat spaces

# Check connectivity
adom-gchat health

# Set up for your org (interactive)
adom-gchat setup

Setting up for your org

  1. Create a webhook in Google Chat: Space settings > Apps & integrations > Webhooks
  2. Run adom-gchat setup and paste the webhook URL
  3. Test with adom-gchat send --space <name> "hello from our org"
  4. Share with your team: adom-gchat publish --org <orgname>

This publishes an org-scoped wiki page that your team's Claude auto-discovers. Your webhook URLs stay private to your org.

Attribution

Every message is prefixed with who sent it: *OrgName (on behalf of username)* message text

Customize the template during setup or in ~/.config/gchat-webhooks.jsonattribution field.

Security

  • Webhook URLs are secrets — never commit them to git or paste in chat
  • The CLI never leaks container slugs or hostnames in messages
  • --space is required — no default space to prevent accidental posts

Sub-Skills
?
What are Sub-Skills?

Sub-skills are community-contributed AI skill extensions for this component. They teach AI assistants about specific tools, configurators, or workflows.

Examples:

  • A manufacturer’s configuration tool for a motor controller
  • A community-written design guide for an amplifier circuit
  • An automated test/validation script for a sensor module

How to add one: Click Add Sub-Skill, provide the URL to your skill and a brief description. Submissions are reviewed by the Adom team before going live.

No sub-skills yet. Be the first to contribute one!

Recent activity

8 commits