briefed

What This Skill Does

Briefed is an AI-powered newsletter intelligence system designed to manage your inbox noise. It functions as a automated pipeline that bridges your Gmail account with an intelligent local web reader. By using Claude Haiku, Briefed autonomously fetches your newsletters, filters them for relevance, and generates concise, high-value summaries. This ensures you only read what matters, formatted for quick consumption.

The system utilizes a multi-step architecture: Python scripts handle data extraction and formatting, while the AI model performs cognitive tasks like summarization. The resulting digest is served via a local web interface that features built-in voting, interest tracking, and notes, ensuring your reading list remains curated and organized based on your evolving preferences.

Installation

1. Install dependencies: Run pip install -r scripts/requirements.txt within the skill directory.
2. Configure Credentials: Set the BRIEFED_GMAIL_CLIENT_SECRET environment variable to point to your Google Cloud Desktop OAuth JSON file.
3. Deploy the Interface: Copy the reader assets to your workspace and run npm install.
4. Initialize Interests: Create a newsletter-interests.json file in your workspace to define topics, or allow the system to generate a default file on the first run.
5. Authenticate: Launch the fetcher; the system will open a browser to authenticate via Google OAuth and generate a local token.

Use Cases

• Daily Digest Generation: Transform dozens of cluttered emails into a single, high-signal briefing every morning.
• Inbox Intelligence: Automatically tag and prioritize newsletter content based on specific professional interests like AI, startups, or design.
• Personal Knowledge Management: Keep a searchable log of newsletter notes and interests to build a long-term knowledge base.

Example Prompts

• "OpenClaw, please set up Briefed to start scanning my inbox for newsletters and summarize the top AI news every day at 8 AM."
• "Briefed, show me my summary of today's tech newsletters and tag the article about vector databases as high priority."
• "I'm currently researching startup trends; please update my Briefed interest settings to prioritize content related to venture capital."

Tips & Limitations

• Security: Briefed uses restricted scopes (gmail.readonly) to ensure your privacy is respected. It cannot send mail or delete items.
• Token Management: Your Gmail token is stored locally. If you rotate credentials, simply delete the token file to re-authenticate.
• Context Window: The system intentionally splits data fetching and summarization to ensure that even long-form newsletters remain within the model's optimal context limits.