> ## 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.

# Overview

> Bring context from the apps you already use into your xysq memory — with filtering rules you control.

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.

<Note>
  Open Integrations at [app.xysq.ai/connect-apps](https://app.xysq.ai/connect-apps). This is different from **Agents** (`/connect-agent`), which is where you connect AI clients like Claude, Cursor, and Windsurf to xysq.
</Note>

## 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](/integrations/apps/gmail).
* **Google Calendar** - live. Connect it and pick which calendars to sync; events flow into your memory tagged `source:gcal`.
* **GitHub** - live, for teams. Connect a team's repos so pull requests, reviews, comments, and pushes flow into the team vault. See [GitHub integration](/integrations/apps/github).
* **Slack** - live, for teams. Connect a team's Slack and pick which channels to watch; messages flow into the team vault. See [Slack integration](/integrations/apps/slack).
* **Outlook, Notion, 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](/integrations/apps/gmail#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](https://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 held back from general recall and only surfaces under the matching privacy sub-scope. See [Vault scopes](/features/vault#scope-what-youre-looking-at) for how that works.

## 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.