# Weavestream Documentation

Welcome to the Weavestream documentation. Use the sections below to find what you're looking for.

# Getting Started

• Welcome to Weavestream — What the app does and key concepts
• Adding Your First API Source — Connect an API, add an endpoint, and sync data
• Navigating the Interface — Sidebar, item list, detail view, and keyboard shortcuts

# Data Sources

• Understanding API Sources & Endpoints — How sources and endpoints relate
• Authentication Methods — Bearer, API Key, Basic, OAuth 2.0, and more
• Configuring Endpoints — HTTP methods, parameters, and request bodies
• Field Mapping — Map API responses to title, summary, date, and status
• Pagination — Cursor-based and page-based pagination
• RSS Feeds — Add and manage RSS/Atom feeds
• Syncing & Refresh — Sync intervals, manual sync, and retention modes

# Browsing & Organizing Data

• Searching & Sorting Items — Search, sort, and filter the item list
• Item Actions — Read/unread, flagging, archiving, and status tags
• Smart Filters — Create rule-based views with conditions
• Endpoint Joins — Combine data from multiple endpoints

# AI Analysis

• Getting Started with AI — Choose and configure an AI provider
• Chatting with Your Data — Ask questions and analyze items
• Custom Analysis Prompts — Create reusable analysis instructions
• Privacy & AI Providers — What data goes where

# Workflows

• Introduction to Workflows — What workflows are and key concepts
• Building Your First Workflow — Step-by-step tutorial
• Workflow Node Reference — Every node type explained
• Scheduling & Running Workflows — Manual runs, scheduling, and run logs

# Settings & Preferences

• General Settings — Appearance, text size, and startup
• Intelligence Settings — Configure Claude and Ollama
• Notifications Settings — macOS notifications and permissions
• Credentials & Security — Keychain storage and credential management
• Data & Storage — Database location, size, and maintenance