# 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

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

## Bootstrap Behavior

- Create the local Feed Sage home in `~/.feed-sage`.
- Ask which agents/editors to configure: Cursor, Claude Code, Codex, Hermes,
  OpenCLWA, Zed.
- Write project MCP config files such as `.mcp.json`, `.cursor/mcp.json`, and
  `.zed/settings.json`.
- Install bundled skills into `.agents/skills`.
- Tell the user to restart their agent/editor and ask Feed Sage to pull and
  summarize research signals.

## Agent Install Prompt

- A copy-paste install prompt is bundled at `prompts/install-feed-sage.md`.
- Use it when the user is already inside Hermes, OpenCLWA, Claude Code, Codex,
  or another agent.
- The prompt checks for npx, bunx, or Cargo and installs all supported agent
  targets with `feed-sage init --targets all --force`.

## Dashboard

- Route: `feed-sage dashboard --port 18523`
- Views: today, topics, deep reads, sources, archive
- Actions: pull now, generate digest, refresh, dark mode, 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.
