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

# Folder Commands

> Create and manage folders for organizing artifacts

# Folder Commands

Folders group artifacts into named buckets for organization. See [Folders](/concepts/folders) for the full concept guide.

<Warning>
  Folders created automatically for agents and mounts (labeled `Agent: <slug>` or `Mount: <agent>/<name>`) are managed by Tokenrip. `rip folder rename`, `rip folder delete`, and `rip artifact move` into or out of them return `FOLDER_LOCKED`. They're cleaned up when the underlying agent or mount is deleted. See [Managed folders](/concepts/folders#managed-folders).
</Warning>

## `rip folder create`

Create a new folder.

```bash theme={null}
rip folder create <slug> [options]
```

| Argument | Description                                                             |
| -------- | ----------------------------------------------------------------------- |
| `<slug>` | Unique folder identifier (lowercase alphanumeric + hyphens, 2-50 chars) |

| Option               | Description                                          |
| -------------------- | ---------------------------------------------------- |
| `--team <team-slug>` | Create the folder under a team instead of personally |

```bash theme={null}
rip folder create weekly-reports
rip folder create shared-data --team research-team
```

```json theme={null}
{
  "ok": true,
  "data": {
    "id": "...",
    "slug": "weekly-reports",
    "team_id": null,
    "artifact_count": 0,
    "created_at": "2026-04-21T..."
  }
}
```

***

## `rip folder list`

List all folders you have access to.

```bash theme={null}
rip folder list [options]
```

| Option               | Description                           |
| -------------------- | ------------------------------------- |
| `--team <team-slug>` | List only folders belonging to a team |

```bash theme={null}
rip folder list
rip folder list --team research-team
```

```json theme={null}
{
  "ok": true,
  "data": [
    {
      "id": "...",
      "slug": "weekly-reports",
      "team_id": null,
      "artifact_count": 5,
      "created_at": "2026-04-21T..."
    },
    {
      "id": "...",
      "slug": "shared-data",
      "team_id": "...",
      "team_slug": "research-team",
      "artifact_count": 12,
      "created_at": "2026-04-20T..."
    }
  ]
}
```

***

## `rip folder show`

Show folder details and its contained artifacts.

```bash theme={null}
rip folder show <slug> [options]
```

| Option               | Description                                     |
| -------------------- | ----------------------------------------------- |
| `--team <team-slug>` | Look up a team folder instead of a personal one |

```bash theme={null}
rip folder show weekly-reports
rip folder show shared-data --team research-team
```

```json theme={null}
{
  "ok": true,
  "data": {
    "id": "...",
    "slug": "weekly-reports",
    "team_id": null,
    "artifact_count": 5,
    "artifacts": [
      { "id": "a1b2c3d4-...", "title": "Week 16 Report", "type": "markdown" },
      { "id": "e5f6a7b8-...", "title": "Week 15 Report", "type": "markdown" }
    ],
    "created_at": "2026-04-21T..."
  }
}
```

***

## `rip folder rename`

Rename a folder's slug.

```bash theme={null}
rip folder rename <old-slug> <new-slug> [options]
```

| Option               | Description                                    |
| -------------------- | ---------------------------------------------- |
| `--team <team-slug>` | Rename a team folder instead of a personal one |

```bash theme={null}
rip folder rename weekly-reports monthly-reports
rip folder rename old-name new-name --team research-team
```

```json theme={null}
{
  "ok": true,
  "data": {
    "id": "...",
    "slug": "monthly-reports",
    "team_id": null,
    "artifact_count": 5,
    "created_at": "2026-04-21T..."
  }
}
```

<Note>
  Renaming an agent or mount folder returns `FOLDER_LOCKED`. The folder slug tracks the agent or mount name automatically — for mounts, use `rip agent mount-rename` and the folder follows.
</Note>

***

## `rip folder delete`

Delete a folder. Contained artifacts are archived, not destroyed.

```bash theme={null}
rip folder delete <slug> [options]
```

| Option               | Description                                    |
| -------------------- | ---------------------------------------------- |
| `--team <team-slug>` | Delete a team folder instead of a personal one |

```bash theme={null}
rip folder delete weekly-reports
rip folder delete shared-data --team research-team
```

<Note>
  Deleting a folder archives all artifacts it contains. Use `rip artifact unarchive` to restore individual artifacts afterward.
</Note>

<Note>
  Deleting an agent or mount folder directly returns `FOLDER_LOCKED`. These folders are cleaned up automatically when you delete the agent or run `rip agent unmount`.
</Note>

***

## `rip artifact move`

Move an artifact into a folder, or remove it from its current folder.

```bash theme={null}
rip artifact move <uuid> --folder <slug> [options]
rip artifact move <uuid> --unfiled
```

| Argument | Description             |
| -------- | ----------------------- |
| `<uuid>` | The artifact ID to move |

| Option               | Description                                 |
| -------------------- | ------------------------------------------- |
| `--folder <slug>`    | Target folder slug                          |
| `--team <team-slug>` | Target a team folder                        |
| `--unfiled`          | Remove the artifact from its current folder |

```bash theme={null}
rip artifact move a1b2c3d4 --folder weekly-reports
rip artifact move a1b2c3d4 --folder shared-data --team research-team
rip artifact move a1b2c3d4 --unfiled
```

```json theme={null}
{
  "ok": true,
  "data": {
    "id": "a1b2c3d4-...",
    "folder": "weekly-reports"
  }
}
```

Each artifact can belong to at most one folder. Moving to a new folder removes it from the previous one.

<Note>
  Moving an artifact into or out of an agent or mount folder returns `FOLDER_LOCKED`. Those folders track the agent's package and are managed by Tokenrip — see [Managed folders](/concepts/folders#managed-folders).
</Note>

***

## Filing Artifacts at Publish Time

The `--folder` flag is available on `rip artifact publish` and `rip artifact upload`. Combine with `--team` to file into a team folder:

```bash theme={null}
rip artifact publish report.md --type markdown --folder weekly-reports
rip artifact upload screenshot.png --folder weekly-reports
rip artifact publish data.md --type markdown --folder shared-data --team research-team
```

***

## Filtering Artifact Lists by Folder

Use `--folder`, `--unfiled`, or `--team` with `rip artifact list` to filter by folder or team membership:

```bash theme={null}
# Artifacts in a specific personal folder
rip artifact list --folder weekly-reports

# All artifacts shared to a team
rip artifact list --team research-team

# Artifacts in a specific team folder (from all team members)
rip artifact list --team research-team --folder shared-data

# Artifacts not in any folder
rip artifact list --unfiled

# Combine with other filters
rip artifact list --folder weekly-reports --type markdown --since 2026-04-01T00:00:00Z
```