Connect a source
Give Brain access to GitHub, Google Drive, or ClickUp content.
Connect GitHub, Google Drive, or ClickUp to let Brain read it. A connection grants access; a daemon chooses what to import and runs the ingestion.
Before you start
You need a Lepsto product and an organization owner or admin who can install and attach a connection. If that isn’t your role, you can request access. A public GitHub repository is the exception: Brain can read it without a connection.
Choose material that can be shared with everyone who has Brain access in this product. All imported memories are shared.
Make a connection available
- Open Integrations in the web app. An organization owner or admin installs the connection with read access to the source.
- Have the owner or admin attach it to your product. If you cannot do this, request the connection and wait for approval.
- Open Brain’s Ingest page and select the source while setting up a daemon. Check the source-specific boundaries below before choosing categories.
Brain uses the organization’s connection; it stores no separate provider credentials and never writes to these sources. If an expected repository or folder is missing, change the connection’s access at the organization level. Brain cannot expand that access itself.
What each source gives Brain
Each content category is an independent switch on the daemon.
GitHub
Private repositories require a GitHub App installation with read access to the repository, issues, and pull requests. Brain reads through a short-lived token for each run. Public repositories can be read anonymously.
One daemon reads one branch of one repository.
Category | Imported content |
|---|---|
Markdown | *.md files and files named README regardless of file suffix. Include/exclude patterns narrow the selection; the default include is **/*.md. |
Issues | Open and closed issues: title, state, labels, and body. |
Pull requests | Open and closed pull requests: title, state, and body. |
Brain does not read other code files, issue or pull-request comments, reviews, commits, diffs, releases, wikis, projects, discussions, actions, or files outside the selected branch.
Google Drive
Connect a Google account and pick the files or folders it makes available. Brain starts only from that picked set. Shared drives are supported; items in Trash are skipped.
Category | Imported content |
|---|---|
Google documents | Docs exported as Markdown, Sheets as CSV, and Slides as plain text. |
PDF | Extractable text. A scan without a text layer is skipped. |
Plain text | Files with types text/plain, text/markdown, or text/csv. |
Folder recursion is on by default. With recursion off, picked folders contribute nothing; only individually picked files are read.
Images, audio, video, archives, Forms, Drawings, and other binary office formats are excluded. Brain reads the current document content, not comments, suggestions, or revision history.
ClickUp
Connect a workspace with read access to its tasks, docs, and chat. A daemon can use the whole workspace or narrow it to one space or a list within a space. With no space selected, it includes every non-archived list in every non-archived space. Select chat channels individually.
Category | Imported content |
|---|---|
Tasks | Name, status, assignees, non-empty custom fields, and body. |
Comments | Comments on imported tasks, with author and date. |
Docs | Each document in scope, page by page. |
Chat | Selected channels’ messages, replies, links, and plain-text attachment content. Off by default. |
The first chat sync reads the previous 7, 30, or 90 days, or all history. The default for a new daemon is 30 days. Later runs read messages newer than the newest one already imported. Changing the initial window afterward does not go back through history already passed.
Brain excludes archived spaces and lists; task attachments, checklists, time tracking, dependencies, and activity history; whiteboards, dashboards, goals, forms, and doc comments. Unselected chat channels are excluded. Other chat attachment types contribute a link and title, not their content.
Trust of what is ingested
Source content | Default authority |
|---|---|
Repository Markdown, Drive files, ClickUp docs | official |
Issues, pull requests, tasks, task comments | team |
ClickUp chat | informal |
A daemon can override these defaults, including choosing policy. The authority is recorded when a memory is written; changing the setting does not retag old memories. See source authority.
Verify it works
While creating a daemon, confirm you can select the intended repository and branch, connected Drive account, or ClickUp workspace and scope. This verifies availability, not ingestion. Continue with a first run and inspect the item outcomes to confirm the source was actually read.
If you detach or uninstall the connection later, affected daemons keep their configuration but fail on access errors. Memories already imported remain in Brain.