Your brain

Sources

Connect Slack, Google Drive, Notion, GitHub and Linear to your brain. What each source brings in, how it stays current, and who can connect it.

A source brings in what your company already writes in another tool. The real copy stays in that tool: Noetix reads it and keeps its own copy current, so you never edit a synced item in Noetix itself.

Connecting a source is for workspace admins. Everything it brings in feeds the whole workspace's brain, and everyone in the workspace can read it.

SourceWhat it brings inHow it stays current
Google DriveDocs, Sheets, Slides and text files you pickChecked for changes on its own
NotionPages and docs you pickChecked for changes on its own
GitHubREADMEs, docs and issues. Never codeChecked on its own, and within a minute or two of a push
LinearProjects, Linear docs and each team's issuesChecked for changes on its own
SlackConversations from the channels you pickOptional: Noetix can watch channels and save what's worth keeping

Sources are on Pro and Team, with no limit on how many you connect. Your website is on every plan.

Connect a source

  1. Open Connectors in the sidebar and choose the Sources tab. Yours lists what is already connected.
  2. Choose the source and press +. You sign in to that tool and approve access.
  3. Back in Noetix, open your Brain and choose Import to pick what to bring in. You choose each file, page or channel. Nothing comes in that you didn't pick.

Google Drive

Brings in the Docs, Sheets, Slides and text files you pick. Google files become text.

  • You pick each file. Choose Choose files in the import window: Google's own file picker opens, and Noetix can read only the files you pick there, never the rest of your Drive. To bring in another file later, pick it the same way.
  • Tick the Drive box when you connect. On Google's screen the Google Drive permission starts unticked, and without it Noetix can't read files.

Notion

Brings in the pages and docs you pick. Each one is checked for changes and replaced when its text changes.

GitHub

Brings in READMEs, docs and issues from the repositories you pick. It never reads code.

  • Connecting installs the Noetix App on your account or organization, and you choose which repositories it may read. It can read files and issues and cannot change anything. To add or remove repositories later, open GitHub's Settings › Applications.
  • Follow a folder to keep everything in it. When you import, each repository lists Every doc and its folders above the single files. Pick a folder (say docs/) and your brain keeps what that folder holds: a doc added there comes in, a doc deleted there leaves, with nothing to re-import. Stop on a followed folder stops following it and takes its docs out.
  • A push reaches your brain in a minute or two. A merge to a repository's default branch that touched a doc is read right away, without waiting for the next check.
  • Each check reads only what changed. Only the docs that commits changed since the last check are read, so a large repository stays current without re-reading everything. If GitHub asks Noetix to slow down, the check waits for the next one: nothing is lost and watching stays on.
  • Issues come in as the open ones plus those closed in the last 30 days, so new issues arrive on each check. They are what What's blocked? reads.

Decision records read as decisions

Keep one file per decision with a Status: line (Active, or Replaced by "Decision: …"; the ADR words Accepted and Superseded by work too), and your brain marks a replaced decision as replaced and answers with the one that holds.

Linear

Brings in the projects, Linear docs and teams' issues you pick. Read only: Noetix changes nothing in Linear. A team's issues are its open ones plus those finished in the last 30 days, so new issues arrive on each check. They are what What's blocked? reads.

Slack

Brings in conversations from the channels you pick. Connecting Slack also gives you @Noetix in Slack, which answers from the brain in the thread (Slack bot).

  • Invite the bot first. Slack only shows channels the Noetix bot was invited to. Run /invite @Noetix in a channel to add it.
  • Watching is off until you switch it on. Watching a conversation means a model deciding what in it is worth keeping, so an admin chooses it: switch on Watch this source on Slack's card in Connectors.
  • You decide what happens before anything is saved. In Settings › General, under When a source syncs, Before saving has three choices:
    • Ask me: everything it wants to save waits in Approvals until you say yes.
    • Traced only: it saves what it can point to in the messages, and drops anything it can't.
    • Automatic: it saves what it finds without asking. Every change can be undone from the page's history.

How sources stay current

Google Drive, Notion, GitHub and Linear are checked on their own once connected. A file whose text changed is read again, and the new copy replaces the old one only once it is built, so a document never drops out of your brain while it updates. Change how often on the source's card in Connectors.

Slack is only read again while watching is on.

When a source stops working

If a source can't be read several times in a row (for example, access was removed in that tool), Noetix stops checking it and marks it Needs attention on the Connectors page, with the reason. Reconnecting usually fixes it. Then switch checking back on.

If your plan stops including sources

Nothing is deleted. Your sources stay connected and what they brought in stays in your brain and keeps answering. They stop syncing, and show Paused on your plan, until your plan includes them again. See Plans and billing.

What sources don't do yet

Everything synced is visible to everyone in the workspace. There are no per-source permissions yet, so connect only what your whole team may read.

  • Deleting a file in the tool doesn't remove it from your brain, unless it was in a GitHub folder you follow. Remove it from the Brain page.
  • Google Drive doesn't find new files on its own. It reads only the files you picked, so a new file in the same folder needs picking too.

Sources are not apps

Your own Gmail, Google Calendar, HubSpot, Jira and more are apps: they never feed the brain, and only your own chats with Noetix Agent read them. See Apps.