Add: Gmail assistant example

[FL4TLiN3]

Add Gmail assistant example with:

• AI-powered email search and reply composition
• OAuth setup assistant (AI guides through Google Cloud setup)
• Local knowledge integration (reads files for context)
• Context management (auto-saves conversation history)
• Gmail draft creation (saves to thread, never sends directly)
• Real-time filtering script for readable output

Features

• setup-assistant: Guides users through Gmail MCP Server setup
• email-assistant: Coordinates email search and reply workflow
• inbox-searcher: Searches Gmail and retrieves email content
• knowledge-finder: Searches local workspace for context
• email-composer: Composes replies and saves to Gmail draft

Files

• examples/gmail-assistant/perstack.toml - Expert definitions
• examples/gmail-assistant/README.md - Setup and usage guide
• examples/gmail-assistant/filter.ts - Real-time output formatter

---

Note

Adds a new Gmail assistant example (with setup assistant, Gmail MCP skills, and output filter) and updates READMEs to reference it.

• Examples:
  • New gmail-assistant in examples/gmail-assistant/:
    • perstack.toml: Defines setup-assistant, email-assistant, inbox-searcher, knowledge-finder, email-composer with @gongrzhe/server-gmail-autoauth-mcp and @perstack/base skills; coordinator/delegation workflow; drafts-only behavior and context file management.
    • README.md: Guided and manual OAuth setup, usage, queries, output, troubleshooting.
    • filter.ts: Formats runtime JSON events into readable logs (search, read, draft, links); prints final result; tracks draft thread IDs.
    • .gitignore: Ignores drafts/, .setup-step, perstack/.
• Docs:
  • Update root README.md with docs/getting-started/Twitter links banner and prominent docs link.
  • Update examples/README.md to include gmail-assistant in the examples table.

^{Written by Cursor Bugbot for commit eadc72d. This will update automatically on new commits. Configure here.}

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

1 Skipped Deployment

Project	Deployment	Preview	Comments	Updated (UTC)
perstack	Ignored			Dec 8, 2025 5:41am

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!