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

# CLI Sources

> Add, list, update, delete, and restore knowledge sources for a Chatbase agent from the terminal.

Use source commands to manage an agent's knowledge base — text, Q\&A pairs, links, and file uploads. For REST details, see [Sources API](/docs/api-v2/sources). Most commands require an agent ID (`-a agt_123`) or a [default agent](/docs/cli/config).

## Add sources

Text snippet:

```bash theme={null}
chatbase sources create --type text --name Guide --content "hello" -a agt_123
```

Website link (crawl mode):

```bash theme={null}
chatbase sources create --type link --url https://example.com --link-type crawl -a agt_123
```

Q\&A pair:

```bash theme={null}
chatbase sources create --type qna --data '{"questions":["Q1"],"answer":"A1"}' -a agt_123
```

File upload:

```bash theme={null}
chatbase sources create --file ./guide.pdf -a agt_123
```

Link types also include `individual` (single page) and `sitemap`.

## List and inspect

List sources for an agent:

```bash theme={null}
chatbase sources list -a agt_123
```

Show one source:

```bash theme={null}
chatbase sources get src_123 -a agt_123
```

View aggregated counts and sizes:

```bash theme={null}
chatbase sources summary -a agt_123
```

## Update, delete, and restore

Update a text, Q\&A, or link source:

```bash theme={null}
chatbase sources update src_123 --data '{"type":"text","content":"updated"}' -a agt_123
```

Replace a file source:

```bash theme={null}
chatbase sources update src_123 --file ./updated.pdf -a agt_123
```

Delete a source (restorable):

```bash theme={null}
chatbase sources delete src_123 -a agt_123
```

Restore a deleted source:

```bash theme={null}
chatbase sources restore src_123 -a agt_123
```

## Train after changes

Adding or updating sources does not retrain the agent automatically. Queue a training job when you are ready:

```bash theme={null}
chatbase agents train -a agt_123
```

See [CLI Agents](/docs/cli/agents) for training and auto-retrain options.

## Commands

| Command                    | Purpose                                                |
| -------------------------- | ------------------------------------------------------ |
| `chatbase sources create`  | Create a source: text/qna/link (JSON) or a file upload |
| `chatbase sources delete`  | Delete a source (restorable via restore command)       |
| `chatbase sources get`     | Show one source                                        |
| `chatbase sources list`    | List sources for an agent                              |
| `chatbase sources restore` | Restore a deleted source                               |
| `chatbase sources summary` | Show aggregated source counts and sizes for an agent   |
| `chatbase sources update`  | Update an existing source (text, qna, link, or file)   |

<Note>
  For every flag, run `chatbase sources <command> --help`.
</Note>