Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.xysq.ai/llms.txt

Use this file to discover all available pages before exploring further.

The Integrations page lets you connect external apps to xysq so their events flow into your memory automatically. Mail, calendar, chat, docs — once connected, xysq watches the apps you care about and ingests what matters, on your terms.
Open Integrations at app.xysq.ai/connect-apps. This is different from Agents (/connect), which is where you connect AI clients like Claude, Cursor, and Windsurf to xysq.

How it works

Each integration is a one-time OAuth handshake. After you connect, xysq receives a stream of events from the upstream app — new email, new calendar event, new Slack message, etc. Every event goes through a two-stage filter pipeline:
  1. Deterministic rules. xysq ships sensible defaults (skip promotions, skip social digests, skip unsubscribable bulk mail). You can override or extend them per integration.
  2. LLM tie-breaker. When a rule explicitly asks for one (llm_hint: ...), a lightweight model decides whether to keep or skip the ambiguous case — confirming a flight booking, recognising a real receipt, that kind of judgement call.
Anything that survives the filter lands in your personal memory bank, gets tagged with its source (source:gmail, source:gcal, etc.), and becomes recallable in chat or in the Vault.

What’s available

The page shows every integration as a card. Currently:
  • Gmail — live. See Gmail integration.
  • Google Calendar, Outlook, Slack, Notion, GitHub, Linear, Jira, Confluence, Granola — coming soon.
Each card shows its status (Connected, Pending, Paused, Not connected) plus, once live, a real-time view of today’s quota usage and a count of how many events have been kept versus skipped.

Activity logs

Every event xysq receives — kept, skipped, dropped on quota — lands in activity logs with a human-readable “why”. You can:
  • Filter by app, by decision (Kept / Skipped / Paused), by date.
  • Search the subject or sender field.
  • See exactly which rule fired, or which LLM verdict was returned, on every row.
  • Click Keep anyway on any skipped or dropped row to override and pull the message into memory after the fact.
Open it at app.xysq.ai/logs. Most integration cards have a “View logs” shortcut that opens the log pre-filtered to that app.

Privacy + caps

xysq enforces a per-user daily event cap on every integration (default: 50 events/day for Gmail). The cap stops a high-volume inbox from drowning out your memory. If you hit it, syncing pauses until midnight UTC. You’ll see a banner across the app whenever any integration is in the paused state. Anything tagged pii or confidential by xysq’s classifier is routed to a restricted bank that’s hidden from general recall — see Vault scopes for how those banks work.

Disconnecting

Disconnecting an integration stops new events from flowing in. It does not delete anything. Memories already ingested stay in your Vault and remain recallable. Your custom filter rules and your full activity-log history are preserved. Reconnect later and you pick up where you left off — same rules, same logs, no double-ingestion of past messages.