morning-ai

name	morning-ai
version	1.3.0
description	Daily-scheduled AI news tracker. Collects updates from 80+ AI entities across 6 sources every 24 hours (default 08:00 UTC+8). Generates scored, deduplicated Markdown reports. Supports unattended cron/scheduled execution with date-stamped idempotent output.
argument-hint	morning-ai, morning-ai --intro, morning-ai --exclude Funding, morning-ai --depth deep, morning-ai --lang zh, morning-ai --schedule "0 9 * * *", morning-ai --lang zh (with MESSAGE_ENABLED=true for message digest, EMAIL_ENABLED=true for email subscription)
allowed-tools	Bash, Read, Write, Edit, WebSearch
homepage	https://github.com/octo-patch/MorningAI
repository	https://github.com/octo-patch/MorningAI
author	octo-patch
license	MIT
user-invocable	true
schedule	{"frequency":"daily","default-cron":"0 8 * * *","timezone":"Asia/Shanghai","idempotent":true,"unattended":true,"estimated-duration":"2-5min"}
metadata	{"openclaw":{"emoji":"📰","requires":{"optionalEnv":["GITHUB_TOKEN"],"bins":["python3"]},"files":["skills/*/scripts/collect.py","skills/*/scripts/gen_infographic.py","lib/*"],"homepage":"https://github.com/octo-patch/MorningAI","tags":["ai","news","tracking","daily-report","model","product","benchmark","funding","multi-source","scheduled","cron","automated","unattended","ai-skill","clawhub"]}}

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 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 | ClawHub

---

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:

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:

   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:

mkdir -p ~/.config/morning-ai && echo "# morning-ai config — free sources only" > ~/.config/morning-ai/.env

---

Language

Parameter	Default	Example
--lang	en (English)	--lang zh (Chinese), --lang ja (Japanese)

Rules:

• Default is English. Unless --lang is explicitly specified, the report MUST be written entirely in English. All report text — titles, summaries, section headers, table labels, bullet points, "Why It Matters" analysis, and all other human-readable content — must be in English.
• If --lang is specified, use that language for all human-readable content instead.
• Entity names are proper nouns (OpenAI, DeepSeek, Midjourney, etc.) — keep them as-is regardless of language.
• When source data is in a different language than the target (e.g. Chinese source → English report), translate it into the target language during report generation. Do NOT leave untranslated fragments.
• The --lang setting also applies to infographic prompt content (see Step 4).

---

Prerequisite: Step 0 must have returned CONFIG_STATUS=READY. If you have not completed Step 0, go back and run it now.

Step 1: Data Collection

Run the Python collector to gather data from automated sources:

cd {SKILL_DIR} && python3 skills/tracking-list/scripts/collect.py --date {YYYY-MM-DD} --depth default -o {CWD}/data_{YYYY-MM-DD}.json

Parameters:

• --date: Target date, default today (YYYY-MM-DD)
• --depth: Collection depth — quick (fast, fewer results), default, or deep (comprehensive)
• --skip: Sources to deliberately skip — e.g. --skip arxiv. Default: skip nothing. Deny-list on purpose: previous --sources allow-list let agents silently drop a collector by forgetting to list it (arxiv was missing from prod for 5 days that way). Naming the skipped source makes the omission visible.
• -o: Output JSON file path

What it does:

• Runs 6 collectors concurrently (Reddit, HN, GitHub, HuggingFace, arXiv, X/Twitter via sub-agent)
• Time window: [Yesterday 08:00, Today 08:00) UTC+8
• Pipeline: collect → score (1-10) → deduplicate → cross-source link → verification bonus
• Returns structured JSON with all items, stats, and collection metadata

Timeout: Allow up to 5 minutes for default depth, 10 minutes for deep.

If the user provides --exclude types (e.g. --exclude Funding), note which content type to filter out in Step 3 (this is a Step 3 filter on item types, not a collect.py flag).

X/Twitter Search

After the automated collection completes, use web search to discover recent X/Twitter updates from tracked entities. The tracked X handles are listed in {SKILL_DIR}/lib/entities.py under X_HANDLES.

Search Strategy: Multi-Layer Account Checking

Search X/Twitter in three layers, in priority order:

Layer 1 — Official Accounts (highest priority): Search for recent posts from official company/product accounts. Handles are listed in entity files under {SKILL_DIR}/entities/.

• Focus: Model releases, product launches, API updates, pricing changes

Layer 2 — CEO / Core Personnel Accounts: Check key people's accounts for announcements, previews, and context that official accounts may not cover. Listed as "Key People" in each entity file.

• Focus: Early previews, strategic context, technical details, competitive commentary

Layer 3 — KOLs & Benchmark Institutions: Check AI opinion leaders and evaluation accounts for independent analysis, benchmark results, and trending discoveries. See {SKILL_DIR}/entities/kol.md and {SKILL_DIR}/entities/benchmarks-academic.md.

• Focus: Paper highlights, benchmark rankings, community trends, independent testing

Search Execution

For each search depth:

Depth	Layer 1 (Official)	Layer 2 (Personnel)	Layer 3 (KOLs)
quick	Top 5 entities by priority	Skip	Skip
default	All major entities (~20)	Top CEO accounts (~10)	Top KOLs (~5)
deep	All entities with X handles	All personnel accounts	All KOLs + benchmark accounts

Use web search queries like:

• site:x.com @{handle} since:{yesterday} — for specific account posts
• site:x.com "{entity name}" AI announcement — for broader discovery
• site:x.com AI model release OR benchmark OR open-source {date} — for trending AI news

RT/Quote Tweet Handling

When a discovered post is a retweet (RT) or quote tweet:

1. Trace to the original post — the event timestamp is the original post time, not the RT/quote time
2. Validate the original post time falls within the 24-hour collection window [Yesterday 08:00, Today 08:00) UTC+8
3. Use the original post URL as the source_url, not the RT/quote URL
4. Credit the original author in source_label (e.g., "@AnthropicAI on X (via @karpathy RT)")

Timeliness Validation

• All X post times must be converted to UTC+8 for window validation
• The collection window is [Yesterday 08:00, Today 08:00) UTC+8
• Posts outside this window are rejected — do NOT include them regardless of relevance
• For RT/quote tweets, validate the original post time, not the retweet time

Source Priority for X-Sourced Items

Priority	Source Type	Credibility
1	Official blog / changelog	Highest
2	Official X/Twitter account	High
3	API changelog / docs	High
4	Official GitHub release	High
5	CEO / core personnel X account	Medium-High
6	Benchmark institution X account	Medium
7	KOL X account	Reference only — requires cross-verification

Items sourced only from KOL accounts (Priority 7) should be scored conservatively and flagged for cross-verification with an official source.

Incorporating X Findings

For each verified X/Twitter update:

1. Create a TrackerItem with source: "x", source_url pointing to the original tweet, and source_label as "@{handle} on X"
2. If the same event was already found by an automated collector (Reddit, HN, GitHub, etc.), merge it as a cross_ref rather than creating a duplicate — this strengthens the verification score
3. If it's a genuinely new finding not in the automated data, add it as a new item with appropriate scoring
4. KOL voice detection (Layer 3 items only): classify the post and tag accordingly:
   • KOL original commentary — independent analysis, paper review, hot-take, prediction, technical review, framework critique. Set is_kol_voice: true on the item. Do NOT dedup-merge into official-source items even if discussing the same topic — the KOL's take is the value, not the underlying news. Score conservatively (4-7 typically) but keep as a standalone item.
   • KOL restating an official announcement — direct paraphrase / quote of vendor news with no added angle. Treat as cross_ref to the official item (existing behavior). Do NOT set is_kol_voice.
   • When in doubt: if the post adds an opinion, comparison, or analysis the official source doesn't have → it's a voice. If it's just "X just shipped Y, link" → it's a cross_ref.

---

Step 2: Read Specifications

After data collection completes, read the tracking specification to understand scoring criteria, record format, and timeliness rules:

Read {SKILL_DIR}/skills/tracking-list/SKILL.md

This specification defines:

• 4 tracking types (Product / Model / Benchmark / Funding) with include/exclude criteria
• Source priority rankings
• Scoring criteria (1-10 scale with 5 dimensions)
• Timeliness validation rules (event date ≠ page date)
• Cross-verification requirements (7+ scores need 2+ independent sources)
• Record format for the report

Internalize the specification before writing the report. Pay special attention to the scoring reference tables and type classification guide.

---

Step 3: Generate Report

1. Read the JSON output from Step 1
2. Read the report template: Read {SKILL_DIR}/templates/report.md
3. Generate report_{YYYY-MM-DD}.md in the working directory

Report generation rules:

• Language: Default is English. Write ALL content in English unless --lang is explicitly specified. If source data is in a different language, translate it. Entity names (proper nouns) stay as-is.
• Source links: Every item MUST include a clickable source link [Source Name](URL) pointing to the original content. This applies to all sections: TLDR, detailed entries, and compact table rows.
• Detail quality: Summary bullet points must include specific details — version numbers, percentage improvements, parameter counts, pricing, availability dates, benchmark scores. Avoid vague descriptions without concrete numbers.
• Factual verification: See skills/tracking-list/SKILL.md → "Factual Detail Verification" for the full protocol. Never write a number from memory or inference — omit unverifiable details.
• Filter out any excluded types (if --exclude was specified)
• Sort items by score within each type section
• TLDR section: Only items with score 7+ (across all types), sorted high to low. Each item includes a one-line summary with specifics, plus an Impact sentence explaining why it matters. Must include a source link [[Source](URL)] at the end.
• Type sections: Group by score range (9-10 / 7-8 / 5-6 / 3-4)
• For items with score 7+, include multi-source verification if available
• Item format: Follow the record format defined in the tracking specification (read in Step 2), including detail level requirements, "Why It Matters", and "Key Data" sections. For mid-score (5-6) and lower-score (3-4) items, use the compact formats defined there.
• KOL Voices section (NEW): From items where is_kol_voice: true (set during Step 1 KOL voice detection), select the top 3-5 by score, capped to max 1 item per KOL handle (no double-dipping). For each item write:
  • KOL display name + linked X handle + score
  • One-line takeaway in the report's language (--lang) explaining why this view matters or what's the unique angle
  • A short excerpt (≤80 chars) from the original post as a blockquote, kept in the post's original language (don't translate the quote — preserve voice)
  • A source link [[Original]({source_url})] If fewer than 3 items qualify, list what's available + append _(Today's KOL channels were quiet — only N items qualified.)_. If 0 qualify, write _Today's KOL channels were quiet._
• Fill in the statistics summary table

---

Step 4: Generate Infographics (Optional)

This step is optional. Skip if no image generation capability is available or configured.

1. Read the infographic specification:

   Read {SKILL_DIR}/skills/gen-infographic/SKILL.md
   

2. Generate cover + per-type sections + stitch (see Image Strategy in skills/gen-infographic/SKILL.md):

   • Always generate cover (9:16 portrait) + per-type section images (9:16 portrait), then stitch into one long image

3. Cover image: Sort by score and select the top 4-5 updates (across all types). Build prompt using the Cover Prompt Template (9:16 portrait).

4. Per-type section images: For each type (Model/Product/Benchmark/Funding/KOL) with qualifying items, build a prompt using the Per-Type Prompt Template (9:16 portrait).

   • Default (IMAGE_GEN_TYPES=auto): only types with 7+ score items. Exception: the KOL section image is generated whenever ≥1 item has is_kol_voice: true (regardless of score), since KOL voices are scored conservatively (4-7) by design — applying the 7+ gate would suppress the section image even when the report has a populated KOL Voices block.
   • KOL section image filename: news_infographic_{YYYY-MM-DD}_kol.png. Insert at the top of the report's ## KOL Voices section (the template already has a stub: ![KOL Voices](news_infographic_{DATE}_kol.png)).
   • Set IMAGE_GEN_TYPES=all for all types, none for cover only

5. Generate images and stitch:

   Option A — Native tool (Claude Code or other tools with built-in image generation): Use your tool's built-in image generation capability, one call per image. Then stitch sections together.

   Option B — Python script batch mode (any environment, requires IMAGE_GEN_PROVIDER configured): Build a manifest JSON with all prompts and outputs, then run:

   cd {SKILL_DIR} && python3 skills/gen-infographic/scripts/gen_infographic.py --batch {CWD}/manifest.json --stitch
   

   Supported providers: gemini, minimax. See Configuration for API keys. Requires pip install Pillow.

   The final output is news_infographic_YYYY-MM-DD_combined.png — a single long image containing cover + all section images.

6. Insert images into the report:

   • Combined long image at the beginning
   • Individual per-type images optionally at the top of each type section

---

Step 5: Generate Social Content (Optional)

Skip this step if SOCIAL_ENABLED is not true or no social channels are configured.

Generate platform-optimized copy and images for social media distribution (X, Xiaohongshu, etc.).

1. Read the social content specification:

   Read {SKILL_DIR}/skills/gen-social/SKILL.md
   

2. Load channel configuration:

   • If SOCIAL_CHANNELS_FILE exists → read the JSON channel list
   • Else if SOCIAL_PLATFORM env var is set → build a single channel from SOCIAL_PLATFORM + SOCIAL_STYLE + SOCIAL_LANG
   • Else → skip this step

3. For each channel: a. Read the channel's template: {SKILL_DIR}/skills/gen-social/templates/{platform}/{style}.md b. Select top items from the report data (filter by min_score, limit by items, translate if lang differs from source) c. Generate copy following the template's format rules, tone, and character limits d. Validate character counts — each tweet ≤ 280 chars, Xiaohongshu title ≤ 20 chars, body ≤ 1000 chars e. Write copy to {CWD}/social/social_{YYYY-MM-DD}_{channel_id}.md f. If channel has image: true — generate platform-adapted images using the same providers as Step 4

   • X: 16:9 or 1:1 aspect ratio
   • Xiaohongshu: 3:4 portrait, carousel multi-image supported g. Write images to {CWD}/social/social_{YYYY-MM-DD}_{channel_id}_{N}.png

4. Write manifest to {CWD}/social/social_{YYYY-MM-DD}_manifest.json listing all generated files

Channel config examples: See skills/gen-social/SKILL.md for the full JSON schema and quick-setup env vars.

---

Step 6: Generate Message Digest (Optional)

Skip this step if MESSAGE_ENABLED is not true.

Generate a concise, share-friendly message digest suitable for messaging platforms (WeChat, Telegram, Slack, etc.). The digest provides bold titles with one-line summaries and reference links — optimized for copy-paste sharing.

1. Read the message specification:

   Read {SKILL_DIR}/skills/gen-message/SKILL.md
   

2. Read the digest template:

   Read {SKILL_DIR}/skills/gen-message/templates/digest.md
   

3. Select items from the report data (data_{YYYY-MM-DD}.json):

   • Filter by score >= MESSAGE_MIN_SCORE (default: 5)
   • Apply category balance if MESSAGE_CATEGORY_BALANCE=true (default): per-type slot caps (product max 4, model max 3, benchmark max 2, financing max 2), fill remaining with top-scoring items
   • Sort by importance score descending
   • Limit to MESSAGE_MAX_ITEMS (default: 10)
   • Use MESSAGE_LANG for language (default: from --lang)

4. Generate text digest following the template format:

   • Write to {CWD}/message_{YYYY-MM-DD}.md
   • Each item: emoji marker + bold title + one-line summary + source link
   • Source link (🔗 URL) after each item by default (or grouped at bottom if MESSAGE_LINKS=bottom)
   • Language-specific header and footer

5. If image generation is available (IMAGE_GEN_PROVIDER is configured):

   • Build a 9:16 portrait image prompt from the specification's image prompt template
   • Generate {CWD}/message_{YYYY-MM-DD}.png using the same image generation method as Step 4 (native tool or Python script)

Output files:

• message_{YYYY-MM-DD}.md — copy-paste text for messaging
• message_{YYYY-MM-DD}.png — accompanying image (only if image generation is configured)

---

Step 7: Send Email Subscription (Optional)

Skip this step if EMAIL_ENABLED is not true.

Deliver the daily digest as multipart HTML email via SMTP to a configured recipient list. This is the only step that performs network egress to subscribers — gen-message / gen-social only generate local files.

1. Read the email specification:

   Read {SKILL_DIR}/skills/gen-email/SKILL.md
   

2. Run the sender script:

   python3 {SKILL_DIR}/skills/gen-email/scripts/send_email.py --date {YYYY-MM-DD}
   

   The script:

   • Reads data_{YYYY-MM-DD}.json and applies the same selection rules as gen-message (filter by EMAIL_MIN_SCORE, category balance, sort by importance, cap at EMAIL_MAX_ITEMS)
   • Loads recipients from EMAIL_RECIPIENTS (env, comma-separated) or EMAIL_RECIPIENTS_FILE (default .claude/recipients.json)
   • Renders HTML + plain text bodies, writes local previews email_{YYYY-MM-DD}.html and email_{YYYY-MM-DD}.txt
   • If EMAIL_DRY_RUN=true: stops after writing previews (no SMTP traffic)
   • Otherwise sends to each recipient via SMTP, attaches message_{YYYY-MM-DD}.png when present, sleeps EMAIL_RATE_LIMIT_DELAY seconds between sends
   • Writes email_{YYYY-MM-DD}_manifest.json with per-recipient status (sent / failed) and error text

3. Required env vars (the script exits with a clear error if missing):

   • EMAIL_SMTP_HOST, EMAIL_SMTP_USER, EMAIL_SMTP_PASSWORD
   • At least one recipient via EMAIL_RECIPIENTS or EMAIL_RECIPIENTS_FILE

Output files:

• email_{YYYY-MM-DD}.html / email_{YYYY-MM-DD}.txt — local previews of what was sent
• email_{YYYY-MM-DD}_manifest.json — send status per recipient (for retry / monitoring)

See skills/gen-email/SKILL.md for full configuration and docs/email-setup.md for SMTP provider quick-start (Gmail / QQ / Outlook / Alibaba Cloud Enterprise Mail).

---

Entity Reference

The entities/ directory contains detailed entity registries organized by tracking group:

File	Scope	Entities
entities/ai-labs.md	Frontier AI Labs + China AI	OpenAI, Anthropic, Google, Meta AI, xAI, Microsoft, Qwen, DeepSeek, + 11 more
entities/model-infra.md	Model Infrastructure	NVIDIA, Mistral, Cohere, Perplexity, AWS, Together, Groq, Apple
entities/coding-agent.md	Coding Agent	Cursor, Cline, OpenCode, Droid, OpenClaw, Windsurf, + 5 more
entities/ai-apps.md	AI Applications	v0, bolt.new, Lovable, Replit, Lovart, Manus, + 2 more
entities/vision-media.md	Vision & Media	Midjourney, Runway, Pika, FLUX, ElevenLabs, + 7 more
entities/benchmarks-academic.md	Benchmarks & Academic	LMSYS, HuggingFace, arXiv channels, industry media
entities/kol.md	Key Opinion Leaders	Andrej Karpathy, AK, Andrew Ng, Swyx, Simon Willison, + 3 more
entities/trending-discovery.md	Trending Discovery	GitHub Trending, Product Hunt, Hacker News, Reddit

Each file lists X/Twitter accounts, key people, official blogs, changelogs, GitHub repos, and other source URLs for every tracked entity. Read these files when you need to verify or supplement the automated collection.

Custom Entities

Users can add their own tracked entities by placing markdown files in entities/custom/ (or ~/.config/morning-ai/entities/, or a path set via CUSTOM_ENTITIES_DIR). Custom entity files use a simplified format — see entities/custom-example.md for the template. Custom entities are automatically merged into the built-in registries at runtime and collected alongside the default 80+ entities.

---

Scheduling

Morning-AI is designed for daily automated execution. Each run produces date-stamped files (report_YYYY-MM-DD.md, data_YYYY-MM-DD.json), making it safe to run on a recurring schedule.

Schedule Configuration

Use --schedule to set a custom cron expression (default: 0 8 * * *):

Parameter	Format	Default	Example
--schedule	Cron expression (5-field)	0 8 * * * (daily 8am)	0 9 * * 1-5 (weekdays 9am)

The schedule is passed to the agent's native scheduler (CronCreate, /loop, system cron, etc.). Morning-AI itself does not run a scheduler — it relies on the host agent or system to trigger runs.

Unattended Behavior

• Idempotent: Re-running on the same date overwrites previous output — no duplicate accumulation
• No interactive prompts: All steps run without user input when API keys are configured
• Partial success: If some sources fail, the report generates with available data and logs warnings
• Timeout: Allow 3 min (default depth) or 5 min (deep)

Agent Integration Examples

Claude Code (CronCreate / loop):

/loop 24h /morning-ai

With custom schedule:

/morning-ai --schedule "0 9 * * 1-5"

System cron (manual setup):

0 8 * * * cd /path/to/workspace && claude -p "/morning-ai"

OpenClaw / always-on bot:

schedule: "0 8 * * *"
skill: morning-ai

---

Configuration

Config File Locations (priority order)

1. Environment variables (highest priority)
2. Project config: .env in skill directory
3. Global config: ~/.config/morning-ai/.env

Config File Format

# ~/.config/morning-ai/.env
GITHUB_TOKEN=ghp_xxx

Free Sources (no API key needed)

Source	API	Rate Limit
Reddit	Public JSON	Generous
Hacker News	Algolia API	Generous
GitHub	Public API (optional token for higher limits)	60 req/hr (unauthenticated)
HuggingFace	Public API	Generous
arXiv	Public API	Generous
X/Twitter	Web search	Generous

Message Digest Configuration

See skills/gen-message/SKILL.md for message digest configuration variables (MESSAGE_ENABLED, MESSAGE_MIN_SCORE, MESSAGE_MAX_ITEMS, MESSAGE_CATEGORY_BALANCE, etc.).

Email Subscription Configuration

See skills/gen-email/SKILL.md for the full list of email variables (EMAIL_ENABLED, EMAIL_RECIPIENTS, EMAIL_SMTP_HOST/PORT/USER/PASSWORD/TLS, EMAIL_FROM, EMAIL_LANG, EMAIL_MIN_SCORE, EMAIL_DRY_RUN, etc.) and docs/email-setup.md for SMTP provider walkthroughs.

---

Security & Permissions

• Data access: Reads public web/platform data only. No private or authenticated content is accessed.
• API keys: Stored locally in .env files. Never transmitted except to their respective APIs.
• File writes: Only writes report files (report_*.md, data_*.json), message digest files (message_*.md, message_*.png), and cache files to the skill/working directory.
• Network: Outbound HTTP/HTTPS requests to public APIs (Reddit, GitHub, etc.). No inbound connections.
• No telemetry: No usage data is collected or sent anywhere.