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

# Brain

> The 14 adside commands for Brain.

See [Using commands](https://docs.adside.ai/cli/commands.md) for how flags, JSON input, paging and confirmations work. Run `adside brain --help` to see what your installed version has.

## brain

### brain list

tree Brain content and document ingestion.

```bash theme={null}
adside brain list --tier workspace|org [flags]
```

| Flag | Value |
| - | - |
| `--tier` (required) | `workspace\|org` |
| `--path` | `<path>=` |

### brain read

page Brain content and document ingestion.

```bash theme={null}
adside brain read --tier workspace|org --path <path>
```

### brain remember

Remember durable workspace facts in memory.md; applied in the background.

```bash theme={null}
adside brain remember --facts <facts> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--facts` (required) | `<facts>` | This turn's durable facts and corrections, in plain sentences |
| `--request-id` | `<id>` | Submission identity (generated automatically if omitted) |
| `--topic` | `<topic>` | Keep the detail in memory/\<topic>.md, e.g. decisions or goals-and-targets |

### brain search

Search Brain pages with bounded keyword scanning.

```bash theme={null}
adside brain search --query <query> [flags]
```

| Flag | Value |
| - | - |
| `--query` (required) | `<query>` |
| `--tiers` | `'<json>'` |
| `--directory` | `<directory>` |
| `--max-results` | `<1-25>=10` |

### brain upload

Upload a local document and start Brain ingestion.

```bash theme={null}
adside brain upload --file <file> [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--file` (required) | `<file>` | PDF, DOCX, PPTX, Markdown, text, email or ZIP |
| `--content-type` | `<content-type>` | Document MIME type |
| `--instructions` | `<instructions>` | Filing instructions |

### brain write

write Brain content and document ingestion.

```bash theme={null}
adside brain write --tier org|workspace --path <path> --content <content> [flags]
```

| Flag | Value |
| - | - |
| `--tier` (required) | `org\|workspace` |
| `--path` (required) | `<path>` |
| `--content` (required) | `<content>` |
| `--content-format` | `body\|document=body` |
| `--commit-message` | `<commit-message>` |

## brain ingest

### brain ingest create

ingest Brain content and document ingestion.

```bash theme={null}
adside brain ingest create --tier org|workspace --registration '<json>' [flags]
```

| Flag | Value |
| - | - |
| `--tier` (required) | `org\|workspace` |
| `--registration` (required) | `'<json>'` |
| `--instructions` | `<instructions>` |

### brain ingest get

job Brain content and document ingestion.

```bash theme={null}
adside brain ingest get --job-id <id>
```

### brain ingest list

jobs Brain content and document ingestion.

```bash theme={null}
adside brain ingest list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--tier` | `org\|workspace` | |
| `--status` | `PENDING\|EXTRACTING\|INGESTING\|COMPLETED\|FAILED` | |
| `--search` | `<search>` | |
| `--limit` | `<1-100>=50` | |
| `--cursor` | `<next>` | The next page, from the previous output. |

## brain organization

### brain organization ingest create

ingest Brain content and document ingestion.

```bash theme={null}
adside brain organization ingest create --tier org --registration '<json>' [flags]
```

| Flag | Value |
| - | - |
| `--tier` (required) | `org` |
| `--registration` (required) | `'<json>'` |
| `--instructions` | `<instructions>` |

### brain organization ingest get

job Brain content and document ingestion.

```bash theme={null}
adside brain organization ingest get --job-id <id>
```

### brain organization ingest list

jobs Brain content and document ingestion.

```bash theme={null}
adside brain organization ingest list [flags]
```

| Flag | Value | What it does |
| - | - | - |
| `--tier` | `org\|workspace` | |
| `--status` | `PENDING\|EXTRACTING\|INGESTING\|COMPLETED\|FAILED` | |
| `--search` | `<search>` | |
| `--limit` | `<1-100>=50` | |
| `--cursor` | `<next>` | The next page, from the previous output. |

### brain organization uploads create

upload Brain content and document ingestion.

```bash theme={null}
adside brain organization uploads create --filename <filename> --content-type application/pdf|application/vnd.openxmlformats-officedocument.wordprocessingml.document|application/vnd.openxmlformats-officedocument.presentationml.presentation|text/plain|text/markdown|message/rfc822|application/zip|application/x-zip-compressed --size-bytes <max 262144000>
```

## brain uploads

### brain uploads create

upload Brain content and document ingestion.

```bash theme={null}
adside brain uploads create --filename <filename> --content-type application/pdf|application/vnd.openxmlformats-officedocument.wordprocessingml.document|application/vnd.openxmlformats-officedocument.presentationml.presentation|text/plain|text/markdown|message/rfc822|application/zip|application/x-zip-compressed --size-bytes <max 262144000>
```


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