arch3rpro/digestpilot

# GitHub Repository: arch3rPro/digestpilot

**URL:** https://github.com/arch3rPro/digestpilot
**Author:** arch3rPro
**Description:** An AI agent toolkit that turns trusted information streams into daily briefs and research-ready evidence.
**Homepage:** 
**Language:** TypeScript

## Stats
- Stars: 2
- Forks: 0
- Open Issues: 0
- Commits: 132
- Created: 2026-05-19T16:45:54Z
- Updated: 2026-06-18T15:22:33Z
- Pushed: 2026-06-18T15:21:27Z

## README
# DigestPilot

[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](./LICENSE)

[中文说明](./README.zh-CN.md) | [Agent examples](./examples/README.md) | [Changelog](./CHANGELOG.md) | [v0.3.0](./docs/releases/v0.3.0.md)

DigestPilot is an AI agent toolkit for turning trusted information streams into daily briefs, trend cards, source reviews, and research-ready evidence.

It is designed for agent runtimes rather than a single hosted app. An agent loads a Skill, uses the local deterministic runtime when needed, and writes the final user-facing artifact from prepared evidence.

## What It Provides

- RSS/Atom daily digests and topic monitoring.
- RSS/Atom feed discovery from pages or URL lists.
- OPML-based feed import and source registry workflows.
- Public trend discovery from public channels such as GitHub repository activity, Hacker News, arXiv, Hugging Face Daily Papers, and curated public URLs.
- Source quality review and source-health maintenance.
- Local-first evidence workspaces for deeper subscription-backed research.
- Generated Claude Code and Codex plugin packages for easier installation.

## Skills

| Skill | Use it for | Output |
| --- | --- | --- |
| [`rss-ai-digest`](./skills/rss-ai-digest/SKILL.md) | RSS/Atom digests, key information, and new-entry monitoring. | Markdown or JSON digest focused on content. |
| [`rss-feed-discovery`](./skills/rss-feed-discovery/SKILL.md) | Discover RSS/Atom feeds from pages or URL lists before source review. | Candidate feeds and reviewable registry patches. |
| [`public-trend-radar`](./skills/public-trend-radar/SKILL.md) | Public-channel trend discovery for AI, technical, product, business, paper, and practical-tip signals. | Evidence-backed trend cards. |
| [`rss-source-curator`](./skills/rss-source-curator/SKILL.md) | Feed quality review, source-health inspection, and registry maintenance. | Reviewable keep/watch/disable/remove recommendations. |
| [`subscription-research-agent`](./skills/subscription-research-agent/SKILL.md) | Local-first research workflows from subscription evidence. | Evidence briefs and agent-written research synthesis. |
| [`release-watch`](./skills/release-watch/SKILL.md) | Watched software release monitoring and upgrade triage. | Upgrade, review, watch, or ignore cards. |

## How Agents Should Use It

1. Load the matching `skills/<skill-name>/SKILL.md`.
2. Read only the reference files required by the task.
3. Resolve the runtime command through the Skill instructions or `DIGESTPILOT_RUNTIME_CMD`.
4. Use explicit paths for registries, state files, source health, workspaces, and outputs.
5. Treat runtime output as evidence and state, not as the final judgment.
6. Write the final artifact in the language and format requested by the user.

DigestPilot keeps daily briefs, source maintenance, public trend discovery, and deep research as separate workflows. For example, failed-feed maintenance belongs to `rss-source-curator`, not to an ordinary daily digest.

## Quick Start

From a repository checkout:

```bash
cd packages/research-cli
npm install
npm run build
npm link
```

Then validate the local runtime:

```bash
node scripts/doctor.mjs
```

The preferred runtime command is `digestpilot-runtime`. The legacy `subscription-research` command remains as a compatibility alias. If a linked command is unavailable, use:

```bash
node packages/research-cli/dist/src/cli.js ...
```

or set:

```bash
export DIGESTPILOT_RUNTIME_CMD="node packages/research-cli/dist/src/cli.js"
```

See [Runtime setup](./docs/runtime.md) for the full fallback and bootstrap flow.

## WebUI Preview

[`apps/web`](./apps/web/README.md) provides a local-first WebUI prototype for DigestPilot. It reads the local SQLite workspace for Featured, All Updates, Daily, Radar, and Sources views, supports light/dark/system themes, and can switch the UI between `zh-CN` and `en-US`.

```bash
cd apps/web
npm install
npm run dev
```

## Example Workflows

Prompt-level examples are in [examples/README.md](./examples/README.md).

Typical agent requests:

- "Prepare an AI/technical RSS digest from my configured sources."
- "Find RSS or Atom feeds from these product and research pages."
- "Monitor this topic and show only new matching entries."
- "Find public AI infrastructure trends and produce trend cards."
- "Check watched software releases and tell me what is worth upgrading."
- "Review failing or low-quality RSS sources."
- "Create a research memo from subscription-backed evidence."

The public trend example fixture is in [examples/public-trend-radar](./examples/public-trend-radar/README.md).

## Plugin Package

The generated Claude Code and Codex plugin package lives in [`plugins/digestpilot`](./plugins/digestpilot/README.md). Root [`skills/`](./skills) remains the source of truth.

After changing Skills or bundled runtime files:

```bash
node scripts/build-plugin.mjs --target all
node scripts/validate-plugin-package.mjs
```

## Repository Layout

```text
skills/                 Agent Skill entrypoints and references
packages/research-cli/   Node/TypeScript deterministic runtime
plugins/digestpilot/     Generated Claude Code and Codex plugin package
examples/                Agent-level usage examples and fixtures
docs/                    Runtime, release, and public reference documents
scripts/                 Bootstrap, doctor, build, and validation scripts
```

Runtime outputs such as `feeds.json`, `seen.json`, `source-health.json`, `digest.md`, `rss-output/`, and `research-workspace/` should stay out of Git.

## Documentation

- [Agent examples](./examples/README.md)
- [Runtime setup](./docs/runtime.md)
- [Research CLI reference](./packages/research-cli/README.md)
- [DigestPilot plugin package](./plugins/digestpilot/README.md)
- [Public Trend Radar example](./examples/public-trend-radar/README.md)
- [Release notes](./docs/releases/v0.3.0.md)