# Feed Sage

> Feed Sage is an AI-native research feed engine. It collects public knowledge
> sources, filters them against user interests, deep reads high-value items, and
> generates content assets for agents and humans.

## Boundaries

- Use Feed Sage for research/content sources: RSS, GitHub, Hacker News, Reddit,
  arXiv, web pages, PDFs, transcripts, bookmarks, and public docs.
- Do not use Feed Sage for messaging tools: Slack, Feishu/Lark, Email, Teams, or
  chat logs.
- The English dashboard is a review/control surface. MCP and skills are the
  primary AI-native surfaces.

## Entry Points

- CLI: `feed-sage pull`, `feed-sage digest`, `feed-sage serve`, `feed-sage dashboard`
- npm: `npx feed-sage@latest init`
- Bun: `bunx feed-sage@latest init`
- MCP: `feed-sage mcp serve`
- Config: `~/.feed-sage/feed.config.toml`
- Data: `~/.feed-sage/data/items.jsonl`
- Event export: `~/.feed-sage/exports/events.jsonl`

## Dashboard

- Route: `feed-sage dashboard --port 18523`
- Views: today, topics, deep reads, sources, archive
- Actions: pull now, generate digest, refresh, deep read URL

## MCP Tools

- `feed_status`: current source and index state
- `feed_pull`: pull enabled sources now
- `feed_search`: search collected items
- `feed_digest`: generate a digest
- `feed_deep_read`: fetch and summarize one URL

## Skills

- `feed-researcher`: use for fresh topic research and current information.
- `feed-curator`: use to turn collected items into digests/radars/briefings.
- `feed-configurator`: use to help users tune sources and interests.
