Folder Commands

Folders group artifacts into named buckets for organization. See Folders for the full concept guide.

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.

`rip folder create`

Create a new folder.

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

rip folder create weekly-reports
rip folder create shared-data --team research-team

{
  "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.

rip folder list [options]

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

rip folder list
rip folder list --team research-team

{
  "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.

rip folder show <slug> [options]

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

rip folder show weekly-reports
rip folder show shared-data --team research-team

{
  "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.

rip folder rename <old-slug> <new-slug> [options]

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

rip folder rename weekly-reports monthly-reports
rip folder rename old-name new-name --team research-team

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

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.

`rip folder delete`

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

rip folder delete <slug> [options]

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

rip folder delete weekly-reports
rip folder delete shared-data --team research-team

Deleting a folder archives all artifacts it contains. Use rip artifact unarchive to restore individual artifacts afterward.

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.

`rip artifact move`

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

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

rip artifact move a1b2c3d4 --folder weekly-reports
rip artifact move a1b2c3d4 --folder shared-data --team research-team
rip artifact move a1b2c3d4 --unfiled

{
  "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.

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.

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:

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:

# 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

Why Tokenrip

Getting Started

Core Concepts

Guides

CLI Reference

Folder Commands

Folder Commands

`rip folder create`

`rip folder list`

`rip folder show`

`rip folder rename`

`rip folder delete`

`rip artifact move`

Filing Artifacts at Publish Time

Filtering Artifact Lists by Folder

​Folder Commands

​rip folder create

​rip folder list

​rip folder show

​rip folder rename

​rip folder delete

​rip artifact move

​Filing Artifacts at Publish Time

​Filtering Artifact Lists by Folder

Folder Commands

`rip folder create`

`rip folder list`

`rip folder show`

`rip folder rename`

`rip folder delete`

`rip artifact move`

Filing Artifacts at Publish Time

Filtering Artifact Lists by Folder