> ## Documentation Index
> Fetch the complete documentation index at: https://docs.rerun.build/llms.txt
> Use this file to discover all available pages before exploring further.

# Brain

> What every coworker of your workspace knows about your company, filled from your website and kept up to date with you.

The Brain is the company knowledge of your workspace: what you sell, to whom, at what price, who works there, how you speak, the tools you use, your customers and your competitors. Every coworker reads it before it works, so you write a fact once instead of repeating it in every soul.

It is also where the workspace keeps what its coworkers share: the shared folder, the shared database and the links they published.

## Open the Brain

Click the workspace pill in the top left corner, then **Brain**. A red count next to it says how many proposals wait for you. You can also open it from the [control center](https://docs.rerun.build/chief-of-staff.md#in-the-control-center) with **Company Brain**, or ask the Chief of Staff to show you a page.

The Brain lives on your workspace's machine, which is set up with your first coworker: until then it says **Your Brain comes with your first coworker**. On Rerun Cloud, the entry stays disabled until your free trial starts.

Every member of the workspace can open and edit the Brain.

[![The Brain open on the Acme Studio company page, with Our voice and Our tools in the list on the left](https://docs.rerun.build/images/brain/brain-page.light.webp)](https://docs.rerun.build/images/brain/brain-page.light.webp)
[![The Brain open on the Acme Studio company page, with Our voice and Our tools in the list on the left](https://docs.rerun.build/images/brain/brain-page.dark.webp)](https://docs.rerun.build/images/brain/brain-page.dark.webp)

## What is inside

The sidebar holds everything, with a search field on top (<kbd>⌘</kbd> <kbd>K</kbd>, or <kbd>Ctrl</kbd> <kbd>K</kbd> on Windows and Linux) that looks through pages, files and tables at once.

| Section | What it holds |
| - | - |
| **Proposals** | The changes your coworkers want to make, waiting for you. See [Proposals](#proposals) |
| **Published** | The links your coworkers published, and who can open each. See [Data and files](https://docs.rerun.build/agents/data.md) |
| **Everyone** | What is filed for the whole workspace: the identity card of your company (one page each for **Company**, **Offering**, **Market**, **Team**, **Voice**, **Tools** and **Priorities**), then every other page not filed under a Box: **Customer**, **Competitor**, **Person**, **Product**, **Decision** and **Note** pages. Product pages fold into a **Products** group. Click **New page** to write one |
| **Boxes** | One entry per Box you can open, with the number of pages and files filed under it. Unfold it to see them, click its name to open the Box. See [Filed by Box](#filed-by-box) |
| **Files** | The shared folder of the workspace. Click the upload button of the section header to [import](#import-files-zip-archives-and-folders) |
| **Database** | The shared database of the workspace, one row per table |

The shared folder and the shared database belong to the whole workspace, whatever Box a coworker sits in. See [Data and files](https://docs.rerun.build/agents/data.md).

## Fill it from your website

The Chief of Staff fills the Brain from your website during onboarding. It reads your site and what is public about your company, and writes the Company pages, then pages for your products and competitors. Each page lists its **Sources**: your website pages, your LinkedIn page, your Google Business Profile, a web search, a company registry.

If the Brain is empty, enter your website under **Your website** and click **Fill from my website**. **Rerun is reading your website** shows while it works, and the pages appear in a few minutes. Or click **Write a page yourself**.

Reading your website again never overwrites a page a person edited, a proposal you accepted or a section you confirmed: those are yours from then on.

> [!NOTE]
>
> On a self-hosted install, reading a website needs `FIRECRAWL_API_KEY`. See [Configuration](https://docs.rerun.build/self-host/configuration.md).

### Unconfirmed sections

A section read from the public web is marked **Unconfirmed**: nobody at your company checked it yet. Coworkers take it as a starting point, not a fact, and say so when their work rests on it. Click **Confirm** once it is right.

## Write and edit pages

A page is a document you edit in place, and it saves as you type (**Saving…**, then **Saved**).

* Type <kbd>/</kbd> for blocks: headings, lists, to-do lists, quotes, code, a divider.
* Type `[[` to link another page. Coworkers link to a page as `[[slug]]`, shown under the title of a new page.
* Pick **File** in the <kbd>/</kbd> menu, or drag a file from the sidebar, to cite a file of the shared folder.
* Change the **Type** of the page from its properties, which also show its **Sources** and when it was **Last edited**, and by whom.
* File it under a **Box** and give it **Tags** from the same properties. See [Filed by Box](#filed-by-box).

From the **More** menu of a page: **Copy link**, **Version history** or **Delete**. Deleting a page means coworkers stop reading it, and the pages linking to it lose the link.

If someone else changes a page while you edit it, the page says so: **Load their version** or **Keep mine**.

### Version history

Every change is kept. Open **Version history** from the **More** menu: each version shows who made it, a person, a coworker, the Chief of Staff, or **Rerun, from your website**. Your own edits made a few minutes apart count as one version.

Pick a version and click **Restore this version**. The page goes back to what it said then, and the current version stays in the history.

## Filed by Box

There is one Brain per workspace, but every page and every file of the shared folder says where it belongs, so each team finds its own things first:

* **Box**: the Box it is filed under, or **Everyone**. What a coworker writes or proposes is filed under its own Box; what you import goes under the Box you pick. Change it from the page or the file at any time.
* **Tags**: free words like `#acme` or `#pricing`, added from the page or the file with **Add tag**. Coworkers tag what they write, and you can add or remove tags.
* **Added by**: the coworker, the person or the website import that first put it in the Brain. It stays the same after later edits.

Filing never hides anything: every coworker can still read every page and every file. A coworker reads the pages of its own Box first, its index lists them on top, and it can keep a search to its Box or to some tags when the whole Brain is too broad.

Moving a coworker to another Box leaves what it already added where it was; what it adds next goes under its new Box. A page filed under a Box you cannot open shows under **Everyone**.

Click a Box in the sidebar to open it: **Read first by** lists its coworkers, then everything filed under it with its tags. **Import** from there files what you bring in under that Box.

## Import files, .zip archives and folders

Click the upload button at the top of the sidebar, in the **Files** header, or **Import** in a Box. Drop files, a `.zip` or a folder, or click **Choose files** or **Choose a folder**.

* A `.zip` is unpacked into a folder named after it, its own folders kept. The files a Mac adds (`__MACOSX`, `.DS_Store`) are left out.
* A folder keeps its tree.
* The **Tags** and the **Box** you set apply to every file of the import, and to the folder it came in, which shows under its Box as one item.

The list shows what will be imported before you click **Import**, and you can remove a file from it. One import takes up to 500 files and 500 MB once unpacked; each file can weigh up to 100 MB. The files land in the shared folder and the upload tray shows their progress.

## Proposals

When a coworker finds a fact on its own, on the web, in a file or in a tool result, it does not write it: it proposes it. Nothing changes until someone accepts.

A proposal shows up three ways:

* in the coworker's chat, as a card (**New Brain page** or **Change to the Brain**) with **Review**,
* on the page it changes (**proposes a change to this page**, with **Review**),
* under **Proposals** in the Brain, with the count in the workspace menu.

Each proposal reads like a headline: who proposes it, the page, and the facts that move, before and after. Click **More details** for the reason and the sources, then **Accept** or **Dismiss**. A dismissed change is never proposed again. If the page changed while the proposal waited, it says so: check that nothing gets lost before you accept.

When nothing waits, **Proposals** says **All caught up**.

## How coworkers read it

Every coworker starts each run with the Company card and an index of the pages, the pages and files filed under its Box first. Before it writes about your company or one of your products, it searches the Brain and reads the page it needs. What a person wrote or confirmed wins over its own memory.

How a page changes depends on where the fact comes from:

| The fact comes from | What happens |
| - | - |
| **You, in a coworker's chat** | The coworker writes the page at once and shows **Brain updated** with **Undo**. Every coworker reads it from its next run |
| **The coworker itself** | It sends a proposal for you to review |
| **You, with the Chief of Staff** | The Chief of Staff writes the page, and asks you before deleting one |

A fact about the company goes to the Brain, never to a coworker's own memory: memory is for its own work. See [Memory](https://docs.rerun.build/concepts.md#memory).

To take the Brain away from a coworker, switch off **Use the company brain** in its **Capabilities** tab. See [Configure a coworker](https://docs.rerun.build/agents/configure.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.