# Brein

> One workspace where a team and its agents share what they know, what they operate, and the work in flight, in one governed system.

## Get started

- [Welcome to Brein](https://docs.trybrein.com/index.md): One workspace where your team and its agents share what you know and what you operate, so context survives the next session, model, or tool.
- [Quickstart](https://docs.trybrein.com/quickstart.md): Add Brein to your coding agent and watch your first piece of team context show up in about a minute.
- [The Driftless loop](https://docs.trybrein.com/concepts/core-loop.md): The two kinds of state a workspace connects, and the loop that turns a signal into reviewed Knowledge.

## Connect

- [CLI Setup](https://docs.trybrein.com/cli/setup.md): Install, authenticate, and start creating context topics.
- [Agent setup](https://docs.trybrein.com/agents/setup.md): Teach coding agents to sync, retrieve, and persist Driftless context.
- [MCP & OAuth](https://docs.trybrein.com/mcp/overview.md): Connect ChatGPT, Claude, and other AI clients to your Brein workspace via the Model Context Protocol.
- [Integrations and Connections](https://docs.trybrein.com/integrations/overview.md): Connect external systems Driftless does not own, as governed, audited, workspace-scoped Connections. What connecting gives you, and what it does not.
- [Notion connector (beta)](https://docs.trybrein.com/integrations/notion.md): Connect Notion as a read-only source: your page metadata and content sync into Driftless, governed and bounded. No writes, no manual Nango setup.
- [Broker](https://docs.trybrein.com/integrations/broker.md): Operate an already-connected provider: run named operations, read its synced data, and materialize external content. Gated, governed, and audited.
- [Self-hosted agents (OpenClaw & Hermes)](https://docs.trybrein.com/integrations/self-hosted-agents.md): Connect Driftless to self-hosted agents like OpenClaw and Hermes Agent, through the CLI skill or the remote MCP endpoint.

## Concepts

- [Workspaces](https://docs.trybrein.com/concepts/workspaces.md): The top-level container for context: belong to many, switch freely, move topics between them.
- [Areas](https://docs.trybrein.com/concepts/areas.md): The navigation domains topics file under: Billing, Auth, Infra. The map a new teammate or agent reads first.
- [Topics and relations](https://docs.trybrein.com/concepts/topics.md): How topics connect code to team knowledge.
- [Governance](https://docs.trybrein.com/concepts/governance.md): A topic becomes Knowledge only once an owner or admin merges it in. Agents propose; the merge is an owner or admin act, runnable by an agent only when explicitly asked.
- [Drift Detection](https://docs.trybrein.com/concepts/drift.md): How Driftless detects when code has changed relative to team context.

## Work & collaborate

- [Collections](https://docs.trybrein.com/concepts/collections.md): The object-native operational substrate. A Collection is a configured table; a Record is one typed row. A CRM, a bug tracker, support tickets, a content calendar: each is a configured Collection, not new code. Reads are active-only and bounded by default; archive, restore and purge are explicit, gov…
- [Notes & Sharing](https://docs.trybrein.com/concepts/notes-sharing.md): Jot a private note, share it with a teammate inbox, or merge it into Knowledge for the whole team.
- [Comments](https://docs.trybrein.com/concepts/comments.md): Thin, anchored annotations that humans and agents leave on a topic or record. Feedback that resolves into an edit, without touching the content itself.

## Guides

- [Guides](https://docs.trybrein.com/guides/overview.md): Pick an outcome and run a real Driftless workflow end to end. Each guide combines Knowledge, Collections, and Integrations into steps you can follow.
- [Operate a Collection with governed context](https://docs.trybrein.com/guides/operate-a-collection.md): Work an operational Record with the team's criteria loaded, not as an isolated table. Read the collection's criterion first, evaluate the record against it, and update state only when it actually changed.
- [Turn agent learning into governed Knowledge](https://docs.trybrein.com/guides/govern-agent-learning.md): Route an agent observation to the right place: a clean Note, a Suggested edit against existing Knowledge, or reviewed Knowledge, with a person deciding what the team commits to as true.
- [Audit and clean workspace context safely](https://docs.trybrein.com/guides/clean-workspace-context.md): Run the vault health audit, read what it flags, and prepare a safe cleanup. Every repair here is reviewable and reversible; nothing destroys Knowledge on its own.
- [Use external context in operational work](https://docs.trybrein.com/guides/external-context-with-broker.md): Pull evidence from a connected tool into a Collection through the Broker, without confusing it with Knowledge or with normal retrieve. Read-only today; the write path is described but gated.

## Agents

- [Librarian and source monitoring](https://docs.trybrein.com/agents/agentic-layer.md): The two narrow background jobs that remain in Driftless.

## MCP reference

- [MCP: Knowledge and governance](https://docs.trybrein.com/mcp/knowledge.md): The context tools over MCP: retrieve and read Topics, write and edit them, walk the graph, audit health, and move a Note through the Note to Knowledge lifecycle.
- [MCP: Collections and operations](https://docs.trybrein.com/mcp/work.md): Search and configure Collections, advance typed Records, and resolve cross-collection Entities through bounded, governed MCP tools.
- [MCP: Integrations and Broker](https://docs.trybrein.com/mcp/integrations.md): Operate an already-connected provider over MCP with the driftless_broker tool: discover operations, read synced data, and materialize external content. Gated, governed, and audited.
- [MCP: Workspace and collaboration](https://docs.trybrein.com/mcp/collaboration.md): The collaboration tools over MCP: leave and resolve comments on any spine object, list workspace members and workspaces, and read proposal outcome stats.

## CLI reference

- [Context Commands](https://docs.trybrein.com/cli/context.md): Create, read, update, and delete context topics from the CLI.
- [CLI: Collections, Records, and Entities](https://docs.trybrein.com/cli/collections.md): Search and list collections, add and advance records, manage cross-collection entities, retrieve with criterion, and retire with archive/purge — all from the CLI.
- [CLI: Integrations and Broker](https://docs.trybrein.com/cli/integrations.md): Connect providers and operate them from the CLI: the setup verbs (integration) and the execution verbs (broker).
- [CLI: Agents](https://docs.trybrein.com/cli/agents.md): Configure the Librarian.
- [CLI: Workspace administration](https://docs.trybrein.com/cli/admin.md): Manage members, areas, repositories, notes, and the audit log from the CLI.
- [Sync](https://docs.trybrein.com/cli/sync.md): An optional team-wide digest of what drifted around your topics.

## API reference

- [API Overview](https://docs.trybrein.com/api/overview.md): Base URL, authentication, and public endpoints.
- [Errors](https://docs.trybrein.com/api/errors.md): The error envelope is part of the agent contract: branch on `code`, never on the message.
- [Workspaces](https://docs.trybrein.com/api/workspaces.md): Manage workspace details, members, and integrations.
- [Topics](https://docs.trybrein.com/api/topics.md): CRUD, governance, relations, and the topic graph.
- [Collections, Records & Entities](https://docs.trybrein.com/api/collections.md): REST endpoints for the operational substrate: configured collections, typed records, and cross-collection entities. Reads are active-only and brief by default; archive, restore and purge are explicit, governed lifecycle routes.
- [Comments, Areas & Tags](https://docs.trybrein.com/api/collaboration.md): REST endpoints for annotations and the topic-organizing registries.
- [Integrations](https://docs.trybrein.com/api/integrations.md): Manage workspace integrations.
- [Broker & Connections](https://docs.trybrein.com/api/broker.md): REST endpoints for operating connected providers. Gated, governed, and audited.
- [Repositories](https://docs.trybrein.com/api/repos.md): Register repository identity for local topic and checkout workflows.
- [Market Data](https://docs.trybrein.com/api/market-data.md): Commercial intelligence over Mexican public-sector suppliers, opportunities, awards, risk marks, and permits — a governed, read-only warehouse with typed refusals and keyset pagination.

## Platform

- [Security](https://docs.trybrein.com/security/overview.md): How Driftless handles encryption, API keys, OAuth, and data protection.

## Other

- [A0 chat shell decision](https://docs.trybrein.com/architecture/a0-chat-shell-decision.md)
- [A1 work session contracts](https://docs.trybrein.com/architecture/a1-work-session-contracts.md)
- [A2 durable work session workflow](https://docs.trybrein.com/architecture/a2-durable-work-session-workflow.md)
- [Agent platform boundary](https://docs.trybrein.com/architecture/agent-platform-boundary.md)
- [Agent platform release gates](https://docs.trybrein.com/architecture/agent-platform-release-gates.md)
- [Agents 100x](https://docs.trybrein.com/architecture/agents-100x.md)
- [Agents sota plan](https://docs.trybrein.com/architecture/agents-sota-plan.md)
- [Analytics event model](https://docs.trybrein.com/architecture/analytics-event-model.md)
- [Chat manager semantic routing](https://docs.trybrein.com/architecture/chat-manager-semantic-routing.md)
- [Chat market intelligence cutover](https://docs.trybrein.com/architecture/chat-market-intelligence-cutover.md)
- [Commercial intelligence rollout report](https://docs.trybrein.com/architecture/commercial-intelligence-rollout-report.md)
- [Connector capability directory](https://docs.trybrein.com/architecture/connector-capability-directory.md)
- [Connector capability platform](https://docs.trybrein.com/architecture/connector-capability-platform.md)
- [Connector experience platform v2](https://docs.trybrein.com/architecture/connector-experience-platform-v2.md)
- [Connector retrieve contract](https://docs.trybrein.com/architecture/connector-retrieve-contract.md)
- [Data artifact views](https://docs.trybrein.com/architecture/data-artifact-views.md)
- [01 diagnostico](https://docs.trybrein.com/architecture/experience-v2/01-diagnostico.md)
- [04 artifact y layout](https://docs.trybrein.com/architecture/experience-v2/04-artifact-y-layout.md)
- [05 arquitectura cognitiva](https://docs.trybrein.com/architecture/experience-v2/05-arquitectura-cognitiva.md)
- [09 revision warehouse](https://docs.trybrein.com/architecture/experience-v2/09-revision-warehouse.md)
- [DECISIONS](https://docs.trybrein.com/architecture/experience-v2/DECISIONS.md)
- [00 EXECUTION QUEUE](https://docs.trybrein.com/architecture/investigations/00-EXECUTION-QUEUE.md)
- [01 ENGINE VALIDATION](https://docs.trybrein.com/architecture/investigations/01-ENGINE-VALIDATION.md)
- [02 DURABLE INVESTIGATION CORE](https://docs.trybrein.com/architecture/investigations/02-DURABLE-INVESTIGATION-CORE.md)
- [03 API AND PROGRESS SURFACE](https://docs.trybrein.com/architecture/investigations/03-API-AND-PROGRESS-SURFACE.md)
- [04 DATA ARTIFACT VIEWS](https://docs.trybrein.com/architecture/investigations/04-DATA-ARTIFACT-VIEWS.md)
- [05 COLLECTION PROMOTION](https://docs.trybrein.com/architecture/investigations/05-COLLECTION-PROMOTION.md)
- [06 SOURCE EXPANSION](https://docs.trybrein.com/architecture/investigations/06-SOURCE-EXPANSION.md)
- [07 EVALS ROLLOUT AND OPERATIONS](https://docs.trybrein.com/architecture/investigations/07-EVALS-ROLLOUT-AND-OPERATIONS.md)
- [DELIVERY REPORT](https://docs.trybrein.com/architecture/investigations/DELIVERY-REPORT.md)
- [Legacy radar keep delete inventory](https://docs.trybrein.com/architecture/legacy-radar-keep-delete-inventory.md)
- [Mastra adoption plan](https://docs.trybrein.com/architecture/mastra-adoption-plan.md)
- [Observability map](https://docs.trybrein.com/architecture/observability-map.md)
- [Platform billing admin](https://docs.trybrein.com/architecture/platform-billing-admin.md)
- [Read surface parity audit](https://docs.trybrein.com/architecture/read-surface-parity-audit.md)
- [Research report contract gaps](https://docs.trybrein.com/architecture/research-report-contract-gaps.md)
- [Runtime manifest design](https://docs.trybrein.com/architecture/runtime-manifest-design.md)
- [Source expansion data rights](https://docs.trybrein.com/architecture/source-expansion-data-rights.md)
- [Surface build parity](https://docs.trybrein.com/architecture/surface-build-parity.md)
- [Web search fixtures and metrics](https://docs.trybrein.com/architecture/web-search-fixtures-and-metrics.md)
- [Web search handoff](https://docs.trybrein.com/architecture/web-search-handoff.md)
- [Web search provider evaluation](https://docs.trybrein.com/architecture/web-search-provider-evaluation.md)
- [Launch runbook](https://docs.trybrein.com/launch/launch-runbook.md)
- [Commercial intelligence v1](https://docs.trybrein.com/market-data/commercial-intelligence-v1.md)
- [Commercial intelligence v1 live eval](https://docs.trybrein.com/market-data/commercial-intelligence-v1-live-eval.md)
- [Api implementation contract](https://docs.trybrein.com/market-data/evidence/api-search-field-profile-20260813/api_implementation_contract.md)
- [Executive summary](https://docs.trybrein.com/market-data/evidence/api-search-field-profile-20260813/executive_summary.md)
- [Executive summary.partial](https://docs.trybrein.com/market-data/evidence/api-search-field-profile-20260813/executive_summary.partial.md)
- [Literal sql execution log](https://docs.trybrein.com/market-data/evidence/api-search-field-profile-20260813/literal_sql_execution_log.md)
- [README.partial](https://docs.trybrein.com/market-data/evidence/api-search-field-profile-20260813/README.partial.md)
- [Research skill loop harness plan](https://docs.trybrein.com/market-data/research-skill-loop-harness-plan.md)
- [Semantic api](https://docs.trybrein.com/market-data/semantic-api.md)
- [Tool contract](https://docs.trybrein.com/market-data/tool-contract.md)
- [Web evidence live smoke](https://docs.trybrein.com/market-data/web-evidence-live-smoke.md)
- [Web market discovery](https://docs.trybrein.com/market-data/web-market-discovery.md)
- [Web market discovery live eval](https://docs.trybrein.com/market-data/web-market-discovery-live-eval.md)
- [Broker rollout runbook](https://docs.trybrein.com/performance/broker-rollout-runbook.md)
- [Budgets](https://docs.trybrein.com/performance/budgets.md)
- [Charter](https://docs.trybrein.com/performance/charter.md)
- [Contracts](https://docs.trybrein.com/performance/contracts.md)
- [Explain audit](https://docs.trybrein.com/performance/explain-audit.md)
- [Gates](https://docs.trybrein.com/performance/gates.md)
- [Integrations test harness](https://docs.trybrein.com/performance/integrations-test-harness.md)
- [Navigation](https://docs.trybrein.com/performance/navigation.md)
- [Retrieve contract](https://docs.trybrein.com/performance/retrieve-contract.md)
- [Rollout](https://docs.trybrein.com/performance/rollout.md)
- [Surface matrix](https://docs.trybrein.com/performance/surface-matrix.md)
- [Views](https://docs.trybrein.com/performance/views.md)
- [Chat deepseek quality baseline](https://docs.trybrein.com/qa/chat-deepseek-quality-baseline.md)
- [Chat regression bank](https://docs.trybrein.com/qa/chat-regression-bank.md)
- [Staging blackbox qa 2026 06 28](https://docs.trybrein.com/qa/staging-blackbox-qa-2026-06-28.md)
- [2026 07 08 pricing stripe implementation](https://docs.trybrein.com/superpowers/plans/2026-07-08-pricing-stripe-implementation.md)

> The links below point to documentation indexes. Follow each `/_llms/` index recursively until you reach documentation pages.

## Indexes

- [Spanish (45 pages)](https://docs.trybrein.com/_llms/es.md): Documentation for Spanish.