morning-ai

Files (55)

• marketplace.json · .claude-plugin/
• plugin.json · .claude-plugin/
• settings.json · .claude/
• .clawhubignore
• plugin.json · .codex-plugin/
• .gitignore
• AGENTS.md
• CHANGELOG.md
• CLAUDE.md
• README.md
• SKILL.md
• openai.yaml · agents/
• email-setup.md · docs/
• styles.md · docs/
• ai-apps.md · entities/
• ai-labs.md · entities/
• benchmarks-academic.md · entities/
• coding-agent.md · entities/
• custom-example.md · entities/
• kol.md · entities/
• model-infra.md · entities/
• trending-discovery.md · entities/
• vision-media.md · entities/
• hooks.json · hooks/
• check-config.sh · hooks/scripts/
• __init__.py · lib/
• arxiv.py · lib/
• cache.py · lib/
• classify.py · lib/
• custom_entities.py · lib/
• dedupe.py · lib/
• email_sender.py · lib/
• email_template.py · lib/
• entities.py · lib/
• env.py · lib/
• github.py · lib/
• hackernews.py · lib/
• http.py · lib/
• huggingface.py · lib/
• image_gen.py · lib/
• image_stitch.py · lib/
• net.py · lib/
• recipients.py · lib/
• reddit.py · lib/
• schema.py · lib/
• score.py · lib/
• snapshots.py · lib/
• util.py · lib/
• x_agent.py · lib/
• report_2026-04-14.md · samples/
• sync.sh · scripts/
• report.md · templates/
• test_email_sender.py · tests/
• test_email_template.py · tests/
• test_recipients.py · tests/

SKILL.md (first lines)

# morning-ai: MorningAI Report Generator

> **Permissions overview:** Collects public data from Reddit, Hacker News, GitHub, HuggingFace, arXiv, and X/Twitter. Requires optional API keys configured in `.env` or `~/.config/morning-ai/.env`. Writes report files to the current working directory. See [Configuration](#configuration) for details.

Track 80+ AI entities across 6 sources. Collect updates from the past 24 hours, score and deduplicate them, and generate a structured Markdown daily report. Covers 4 types: **Product** (feature launches, version releases), **Model** (new models, open-source weights), **Benchmark** (leaderboard changes, papers), **Funding** (rounds, acquisitions, milestones).

---

## `--intro` — Product Introduction

If the user passes `--intro`, display the following introduction and **stop** (do not proceed to data collection):

---

**MorningAI** — Daily AI news tracker that monitors 80+ entities across 6 sources.

**What it does:**
- Collects updates from Reddit, Hacker News, GitHub, HuggingFace, arXiv, and X/Twitter
- Scores and deduplicates items on a 1-10 scale with cross-source verification
- Generates structured Markdown reports with 4 content types: Product, Model, Benchmark, Funding
- Optional: infographic images (5 visual styles), message digests (WeChat/Telegram/Slack), social media copy (X/Xiaohongshu)

**Sources (all free, no API keys required for basic usage):**
| Source | Method | API Key |
|--------|--------|---------|
| Reddit | Public JSON | Not needed |
| Hacker News | Algolia API | Not needed |
| GitHub | REST API | Optional (`GITHUB_TOKEN` for higher rate limits) |
| HuggingFace | Public API | Not needed |
| arXiv | Public API | Not needed |
| X/Twitter | Web search | Not needed |

**Quick start:**
```
/morning-ai                     # Run with defaults (English, all types)
/morning-ai --lang zh           # Chinese report
/morning-ai --depth deep        # Comprehensive collection
/morning-ai --exclude Funding   # Skip funding news
```

**Optional features (require API keys):**
- Infographic images: set `IMAGE_GEN_PROVIDER` + provider API key
- Social media copy: set `SOCIAL_ENABLED=true`
- Message digest: set `MESSAGE_ENABLED=true`
- Email subscription: set `EMAIL_ENABLED=true` + SMTP credentials (Gmail/QQ/Outlook/etc.)

**Config file:** `~/.config/morning-ai/.env` — run `/morning-ai` without config to trigger guided setup.

**Version:** 1.3.0 | [GitHub](https://github.com/octo-patch/MorningAI) | [ClawHub](https://clawhub.ai/skills/morning-ai)

---

After displaying the introduction, **stop**. Do not proceed to Step 0 or data collection.

---

## Step 0: Configuration Gate (REQUIRED — must complete before any other step)

**Run this command FIRST before doing anything else:**

```bash
if [ -f "$HOME/.config/morning-ai/.env" ] || [ -f ".claude/morning-ai.env" ] || [ -f ".env" ]; then echo "CONFIG_STATUS=READY"; else echo "CONFIG_STATUS=MISSING"; fi
```

**Branch on the output:**

- **If output is `CONFIG_STATUS=READY`** — read the config file, report which sources are active, then proceed to Step 1.
- **If output is `CONFIG_STATUS=MISSING`** — **STOP. You MUST complete the First-Time Onboarding below before proceeding to Step 1.**

### First-Time Onboarding (when `MISSING`)

> **CRITICAL: STOP HERE.**
> You MUST complete all onboarding steps below interactively with the user.
> Do NOT run Step 1 (data collection) until a config file exists and the gate check returns `READY`.
> Running data collection without configuration will produce incomplete results.

Walk the user through setup interactively, waiting for their response at each step:

1. **Welcome** — briefly explain what morning-ai does: tracks 80+ AI entities across 6 sources (Reddit, Hacker News, GitHub, HuggingFace, arXiv, X/Twitter), generates scored daily reports
2. **Show what works for free** — 6 sources (5 need no API keys, 1 optional):
   - Reddit (public JSON), Hacker News (Algolia API), HuggingFace (public API), arXiv (public API), X/Twitter (web search)
   - GitHub (public API, optional `GITHUB_TOKEN` for higher rate limits)
3. **Ask the user** if they want to enable GitHub with higher rate limits:

| Key | Source | Get it at |
|-----|--------|-----------|
| `GITHUB_TOKEN` | GitHub releases & repos (higher rate limit) | https://github.com/settings/tokens |

4. **Ask about infographics** (optional):

| Key | Description |
|-----|-------------|
| `IMAGE_GEN_PROVIDER` | Provider: `gemini` \| `minimax` \| `none` (default: none) |
| `IMAGE_STYLE` | Style: `classic` \| `dark` \| `glassmorphism` \| `newspaper` \| `tech` |
| `GEMINI_API_KEY` | Google Gemini/Imagen (https://aistudio.google.com/apikey) |
| `MINIMAX_API_KEY` | MiniMax global(https://www.minimax.io) |
| `MINIMAX_API_KEY` | MiniMax cn (https://platform.minimaxi.com) |

5. **Ask about social content distribution** (optional):
   - Enable social content generation? Set `SOCIAL_ENABLED=true`
   - Which platforms? X (Twitter), Xiaohongshu (Little Red Book), or both
   - For advanced multi-account/multi-style setup, create `~/.config/morning-ai/social_channels.json` (see `skills/gen-social/SKILL.md` for schema). For quick single-channel setup, just set `SOCIAL_PLATFORM`, `SOCIAL_STYLE`, and `SOCIAL_LANG` env vars.

6. **Ask about message digest** (optional):
   - Enable concise message digest for sharing on messaging platforms (WeChat, Telegram, Slack)?
   - If yes: set `MESSAGE_ENABLED=true`
   - Optional settings: `MESSAGE_MIN_SCORE` (default 5), `MESSAGE_MAX_ITEMS` (default 10), `MESSAGE_LINKS` (`bottom` or `inline`), `MESSAGE_CATEGORY_BALANCE` (default true, distributes slots across content types)

7. **Create the config file** — collect the keys the user provides and write them to `~/.config/morning-ai/.env` in `KEY=value` format (one per line). Create the directory if needed: `mkdir -p ~/.config/morning-ai`
8. **Confirm** — show how many sources are now active (N/9)
9. **Verify** — re-run the gate check to confirm `CONFIG_STATUS=READY`:
   ```bash
   if [ -f "$HOME/.config/morning-ai/.env" ] || [ -f ".claude/morning-ai.env" ] || [ -f ".env" ]; then echo "CONFIG_STATUS=READY"; else echo "CONFIG_STATUS=MISSING"; fi
   ```
   Only proceed to Step 1 if the output is `READY`.
10. If the user wants to skip API key setup and use only free sources, create a minimal config file first, then proceed to Step 1:
   ```bash
   mkdir -p ~/.config/morning-ai && echo "# morning-ai config — free sources only" > ~/.config/morning-ai/.env
   ```

From octo-patch/MorningAI, MIT.

More from octo-patch/MorningAI