Skill

recipe-stream-inbox

From gws

Stream real-time Gmail notifications using gws gmail +watch for continuous inbox monitoring.

Install

npx claudepluginhub fakoli/fakoli-plugins --plugin gws

Tool Access

This skill uses the workspace's default tool permissions.

Preview

Stream real-time Gmail notifications using `gws gmail +watch` for continuous inbox monitoring.

SKILL.md

Similar Skills

agent-eval

Compares coding agents like Claude Code and Aider on custom YAML-defined codebase tasks using git worktrees, measuring pass rate, cost, time, and consistency.

everything-claude-code

157.7k

agent-harness-construction

Designs and optimizes AI agent action spaces, tool definitions, observation formats, error recovery, and context for higher task completion rates.

everything-claude-code

157.7k

accessibility

Designs, implements, and audits WCAG 2.2 AA accessible UIs for Web (ARIA/HTML5), iOS (SwiftUI traits), and Android (Compose semantics). Audits code for compliance gaps.

everything-claude-code

157.7k

Stats

Parent Repo Stars2

Parent Repo Forks0

Last CommitMar 22, 2026

Used By2 plugins

Actions

View Source View Plugin View on GitHub View README

Stream Inbox in Real-Time

Stream real-time Gmail notifications using gws gmail +watch for continuous inbox monitoring.

When to Use

Use this workflow when the user wants real-time monitoring of their inbox — watching for new emails as they arrive rather than polling.

Prerequisites

Full scopes required: gws auth login --full (needs Pub/Sub access)

GCP project with Pub/Sub API enabled

Set project ID: export GOOGLE_WORKSPACE_PROJECT_ID=my-project-id

Steps

Ensure full scopes are active:

gws auth status
# If missing pubsub scope:
gws auth login --scopes gmail,pubsub,cloud-platform

Start the real-time stream:

gws gmail +watch --project my-project-id

This outputs NDJSON — one JSON object per line for each new message.

Process the stream (example — log new emails):

gws gmail +watch --project my-project-id | while read -r line; do
  echo "$line" | jq '{from: .from, subject: .subject, date: .date}'
done

Combine with triage for a live dashboard:

# Periodic check alongside the stream
gws gmail +triage --max 5 --format table

Caution

The +watch command runs continuously — it will not exit on its own

Requires a GCP project with Pub/Sub topic configured

Uses Pub/Sub quota — monitor usage in Google Cloud Console

Stream output can be large — always pipe through jq or similar filters

Tips

Use Ctrl+C to stop the stream

Combine with --sanitize to scan incoming emails for prompt injection

Pipe to a log file for persistent monitoring: gws gmail +watch >> inbox.ndjson

Stream Inbox in Real-Time

Stream real-time Gmail notifications using gws gmail +watch for continuous inbox monitoring.

When to Use

Use this workflow when the user wants real-time monitoring of their inbox — watching for new emails as they arrive rather than polling.

Prerequisites

Full scopes required: gws auth login --full (needs Pub/Sub access)
GCP project with Pub/Sub API enabled
Set project ID: export GOOGLE_WORKSPACE_PROJECT_ID=my-project-id

Steps

Ensure full scopes are active:

gws auth status
# If missing pubsub scope:
gws auth login --scopes gmail,pubsub,cloud-platform

Start the real-time stream:
```
gws gmail +watch --project my-project-id
```
This outputs NDJSON — one JSON object per line for each new message.

Process the stream (example — log new emails):

gws gmail +watch --project my-project-id | while read -r line; do
  echo "$line" | jq '{from: .from, subject: .subject, date: .date}'
done

Combine with triage for a live dashboard:

# Periodic check alongside the stream
gws gmail +triage --max 5 --format table

Caution

The +watch command runs continuously — it will not exit on its own
Requires a GCP project with Pub/Sub topic configured
Uses Pub/Sub quota — monitor usage in Google Cloud Console
Stream output can be large — always pipe through jq or similar filters

Tips

Use Ctrl+C to stop the stream
Combine with --sanitize to scan incoming emails for prompt injection
Pipe to a log file for persistent monitoring: gws gmail +watch >> inbox.ndjson