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

# Folders

> Organize resources of a given kind into folders with defineFolder.

**Folders** organize resources in the workspace UI. They are **per-kind** — a `model` folder and an `agent` folder are separate namespaces — so you place each resource in a folder of its own kind. You define one with `defineFolder`.

## Define folders

```ts folders/crm.ts theme={null}
import { defineFolder } from "@cargo-ai/cdk";

export const modelsFolder = defineFolder("crm-models", { kind: "model", name: "CRM" });
export const agentsFolder = defineFolder("crm-agents", { kind: "agent", name: "CRM" });
```

Pass a folder handle into the resource it organizes:

```ts theme={null}
export const contacts = defineModel("contacts", {
  dataset: hubspot,
  extractSlug: "fetchRecords",
  folder: modelsFolder,
});
```

## From the CLI

```bash theme={null}
cargo-ai workspaceManagement folder list
cargo-ai workspaceManagement folder create --name "Enrichment" --emoji-slug sparkles --kind tool
```