An integration brings items into your workspace's memory on its own. Today that means a public RSS or Atom feed: a blog, a changelog, a news source. Each entry in the feed becomes a memory your team's AI can recall, in the project and tags you pick, and new entries arrive without anyone doing anything.
Only owners can add or change integrations, because a row can hold a key.
Adding a feed
At Settings > Integrations > Add integration:
- Address - the feed's URL. Public feeds only.
- Name - how it's listed. Anything you like.
- Project and Tags (optional) - where its items go.
Add integration reads the feed before it saves anything, so an address that can't be read isn't added, and you're told why.
What lands in memory
- One memory per feed entry, in the project and tags you chose.
- Each carries a
source:rsstag and a producer such asrss:example.com, so you can filter to it, or away from it, when you recall. - An entry that changes in the feed updates its memory in place.
- A memory you delete is never brought back. It shows as Skipped in the run.
Syncing
A sync reads the feed and writes what's new. It runs about every hour on its own. That's a floor, not a promise of freshness: the automatic sync is never more frequent than hourly, and may be a little later.
Sync now on an integration's page reads the source straight away. Opening one shows its Last run: when it started, how it ended, and how many items were Added, Updated, Unchanged and Skipped. Entries it Left out are listed with the reason, and the log sits in a fold.
The list shows each one's State:
| State | Means |
|---|---|
| Active | The last sync worked |
| Not synced yet | Added, first sync still to come |
| Syncing / Sync queued | A run is on its way |
| Failing | The last sync failed. The page shows the error as the source gave it, and when it last worked |
| Disabled | Switched off |
When a sync fails
The integration shows Failing as soon as a sync fails. It's tried again a couple of times straight away, and if those fail too the next hourly sync tries again. It recovers by itself once the source answers; there's nothing to reset.
Workspace owners are told once when an integration starts failing and once when it works again, in their inbox and through the workspace's alert rules that deliver alerts, not on every attempt. Items already brought in stay put throughout.
Editing, disabling and removing
- Edit - change the address, name, project or tags. A new project or tags apply to items brought in from then on; memories already there aren't moved.
- Disable (then Enable) - stop syncing but keep the settings and the items. Enable reads the feed first, so a source that has since gone away is caught there.
- Remove - stops the integration and deletes its settings. The items it brought in stay.
Adding the same feed again after Remove brings its entries in again, as new copies, because Kythene no longer remembers which ones it had.