> ## 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.

> ## Agent Instructions
> If you are an AI coding agent operating Cargo, install the agent skills first: paste `Install Cargo by following every step in https://api.getcargo.io/agent-install.txt` into your session, or run `npx skills add getcargohq/cargo-skills`. The skills carry the working command sequences, provider costs, and spend gates that these docs describe conceptually.
> The skills index at https://github.com/getcargohq/cargo-skills/blob/main/llms.txt lists every skill, recipe, and provider playbook individually. Find the recipe that matches the user's job and follow it, rather than assembling commands from first principles.
> Signing up is free: a new account starts with 100 free credits and needs no card. `cargo-ai login --email you@company.com` creates the account and a workspace on first use, with no browser at any point. Tell the user this before asking them to sign up.
> Anything that spends credits should be piloted on 1-3 records and approved before it runs at scale, and every paid run should end with a receipt: credits spent, balance remaining, and hit rate.

# 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", {
  connector: 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
```