Brain - Gumloop

Company Brain is your organization’s knowledge base — the documents, messages, and files you’ve connected and indexed. gumloop brain searches it with the same hybrid (semantic + keyword) search your agents use, and syncs local folders into file-upload sources.

Brain is available on the Pro and Enterprise plans. Searches and indexing consume Gumloop credits.

Sync a folder

gumloop brain sync ./docs --create "Engineering docs"

The first run creates a file-upload source and uploads every file in the folder (subfolders included, dotfiles skipped). Re-running compares each file’s name and sha256 against the source and uploads only what is new or changed; indexing starts on its own after each upload.

Source PFqdAMir8PA2Xc6qcszSN9 (active)
1 uploaded, 1 replaced, 0 pruned, 3 unchanged
Skipped notes.exe: unsupported file type ".exe"

gumloop brain sync ./docs --source <source_id> --prune       # existing source; remove remote files that are gone locally
gumloop brain sync ./runbooks --create "Runbooks" --team-id <team_id>
gumloop brain sync ./policies --create "Policies" --scope organization --require-approval --approve
gumloop brain sync ./docs --source <source_id> --dry-run

Flag	Description
`--source`	Id of an existing source to sync into. Exactly one of `--source` or `--create` is required.
`--create`	Create a new source with this name. Personal by default; add `--team-id` (or `--scope team --team-id`) for a team source, `--scope organization` for an organization source.
`--require-approval`	With `--create`: start as a draft that estimates credits before indexing (see below).
`--prune`	Delete files from the source that no longer exist locally. Off by default.
`--approve`	Approve a draft source once its estimate is ready.
`--dry-run`	Print the plan without uploading or deleting.
`--json`	Print the result as JSON (`uploaded`, `replaced`, `pruned`, `unchanged`, `rejected`, `estimate`).

Accepted file types are PDF, Word, PowerPoint, Excel, and text (.txt, .md, .html, .csv, .rtf), up to 25 MB each. Anything else is reported as skipped and left alone.

Drafts and credit estimates

Without --require-approval a source is active and each upload is indexed and billed right away. With it, the source is a draft: uploads run a credit estimate, the source owner is notified in Gumloop, and nothing is indexed until it is approved.

gumloop brain sources estimate <source_id>
# Estimate (paused_for_approval): 5 credits for 2 files (75 tokens).
gumloop brain sources approve <source_id>

Sources and files

gumloop brain sources list [--scope personal|team|organization] [--source-type direct_file_uploads]
gumloop brain sources create "Engineering docs" [--scope team --team-id <team_id>] [--require-approval]
gumloop brain sources get <source_id>
gumloop brain sources delete <source_id>

gumloop brain files list <source_id>
gumloop brain files upload <source_id> ./handbook.pdf ./release.md
gumloop brain files delete <source_id> <file_id>

sources list shows every source you can see, including ones connected in the app such as Notion or Google Drive. Only file-upload sources can be created from the CLI. files list shows each file’s indexing status (uploaded, indexing, indexed, failed) and sha256. Every command takes --json.

Search

gumloop brain search "onboarding process"

The query returns the most relevant snippets across every source you can access — your Personal sources plus any Team and Organization sources shared with you.

SCORE   SOURCE          TITLE                   URL
0.871   notion          Onboarding Checklist    https://www.notion.so/Onboarding-Checklist-2f1a9c7e
0.804   google_drive    New Hire Handbook       https://docs.google.com/document/d/1a2b3c

Options

Flag	Description
`--limit`	Maximum number of results to return (1–50). Defaults to 8.
`--source`	Filter by source type. Repeat the flag to allow several, e.g. `--source notion --source slack`. Valid values: `notion`, `google_drive`, `slack`, `github`, `confluence`, `direct_file_uploads`, `gumloop_artifacts`.
`--json`	Print the raw response payload instead of the table.

gumloop brain search "pricing" --limit 5 --source notion --json

The --json output includes the full result objects — document_id, source, title, content, url, score, updated_at, owner_name, owner_email, parent_title, and metadata — which is handy for piping into jq or another tool.

Company Brain

How Brain indexes your knowledge and how agents use it.

Brain API

Search, sources, and file uploads over the REST API.

​Sync a folder

​Drafts and credit estimates

​Sources and files

​Search

​Options

​Related

Company Brain

Brain API

Sync a folder

Drafts and credit estimates

Sources and files

Search

Options

Related