How rssnext/folo works
Folo is a cross-platform AI RSS reader: users follow diverse sources, read a unified timeline, and can use AI to ask about content, summarize, or translate it. Its product surfaces include desktop/web, mobile, and a CLI. The sampled code shows CLI command registration and client setup, renderer AI-chat support, mobile query persistence, and sync applying remote changes. README claims preserve broader product capabilities, but backend and much renderer/mobile runtime wiring were not sampled, so those links are documented rather than implementation-level.
Main entry points: sync-engine.ts Sync engine · App.tsx Desktop and web · commands CLI commands · ai-chat AI chat
Components 18
User surfaces
- Desktop and web
apps/desktop/layer/renderer/src/App.tsx - Mobile app
apps/mobile/src/main.tsx - CLI program
apps/cli/src/program.ts - CLI commands
apps/cli/src/commands - CLI API client
apps/cli/src/client.ts - CLI output
apps/cli/src/output.ts
Reading and feeds
- Followed sources
- Unified timeline
packages/internal/store/src/modules/entry/store.ts - Subscriptions
packages/internal/store/src/modules/subscription/store.ts
AI assistance
- AI chat
apps/desktop/layer/renderer/src/modules/ai-chat - AI context search
apps/desktop/layer/renderer/src/modules/ai-chat/editor/plugins/mention/hooks/useMentionSearchService.ts - Chat sessions
apps/desktop/layer/renderer/src/modules/ai-chat-session - Summaries and translations
apps/desktop/layer/renderer/src/atoms/ai-summary.ts
Sync and state
- Sync engine
packages/internal/store/src/sync/sync-engine.ts - Entry updates
packages/internal/store/src/modules/entry/hooks.ts - Unread state
packages/internal/store/src/modules/unread/store.ts
Other components
- Reader
- Folo service
Connections 18
- Reader → Desktop and web: reads with
- Reader → Mobile app: reads with
- Reader → CLI program: uses
- Followed sources → Subscriptions: follows
- Subscriptions → Unified timeline: organize reading
- Desktop and web → Unified timeline: reads timeline
- Mobile app → Unified timeline: reads timeline
- CLI program → CLI commands: registers
apps/cli/src/program.ts - CLI commands → CLI API client: requests data
apps/cli/src/commands/subscription.ts - CLI commands → CLI output: formats results
apps/cli/src/commands/subscription.ts - CLI API client → Folo service: calls API
- Desktop and web → AI chat: offers AI chat
- AI chat → AI context search: searches context
apps/desktop/layer/renderer/src/modules/ai-chat/editor/plugins/mention/hooks/useMentionSearchService.ts - AI chat → Chat sessions: manages sessions
apps/desktop/layer/renderer/src/modules/ai-chat/components/layouts/shared/useChatSessionHandlers.tsx - Reader → Summaries and translations: uses
- Sync engine → Folo service: pulls changes
- Sync engine → Entry updates: refreshes entries
packages/internal/store/src/sync/sync-engine.ts - Sync engine → Unread state: resets unread state
packages/internal/store/src/sync/sync-engine.ts