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

# Reloops CLI and Public API

> Use the Reloops CLI and public API to list assigned work, manage projects and assets, create comments, upload files, capture websites, and create share links.

The Reloops CLI wraps the public agent API used by developer keys. Use it when an agent or workflow needs a scriptable path into the same workspaces, projects, assets, comments, collections, screenshots, uploads, and share links that the web app uses.

## Install and configure

Install the CLI or run it with `npx`:

```bash theme={null}
npm install -g reloops-cli
npx reloops-cli --help
```

Set the developer key generated from [AI Agents and Developer Keys](/developers/ai-agents-and-developer-keys):

```bash theme={null}
export RELOOPS_API_KEY="reloops_live_YOUR_API_KEY"
```

The production API base is:

```text theme={null}
https://api.reloops.app/functions/v1
```

For local Supabase development, pass `--local` or set `RELOOPS_BASE_URL`:

```bash theme={null}
reloops-cli --local workspaces list
RELOOPS_BASE_URL="http://127.0.0.1:54321/functions/v1" reloops-cli workspaces list
```

## Common commands

```bash theme={null}
reloops-cli doctor
reloops-cli assigned requested-review --limit 10
reloops-cli actors list
reloops-cli workspaces list
reloops-cli projects list --workspace-id ws_123
reloops-cli projects tree proj_123
reloops-cli assets search --workspace-id ws_123 --query "approved launch videos"
reloops-cli assets semantic-search --workspace-id ws_123 --query "brand logo on dark background"
reloops-cli comments create --asset-id asset_123 --body "Tighten the intro pacing." --media-ms-start 2000
reloops-cli screenshots create --workspace-id ws_123 --project-id proj_123 --url https://example.com
reloops-cli shares create --asset-id asset_123
```

Preview a request without sending it:

```bash theme={null}
reloops-cli --dry-run assets update asset_123 --status approved
```

## Upload a file

Use the single-file helper for normal uploads:

```bash theme={null}
reloops-cli upload single-file ./final.mp4 --workspace-id ws_123 --project-id proj_123 --folder-id folder_123
```

For larger or custom upload flows, use the upload control-plane commands:

* `upload start`
* `upload sign`
* `upload sign-batch`
* `upload complete`
* `upload abort`

## Command surface

The CLI covers the main public API surface:

| Area                 | Commands                                                                                                                                                                               |
| -------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Assigned work        | `assigned list`, `assigned requested-review`                                                                                                                                           |
| Actors               | `actors list`                                                                                                                                                                          |
| Workspaces           | `workspaces list`, `workspaces create`                                                                                                                                                 |
| Projects             | `projects list`, `projects create`, `projects get`, `projects tree`, `projects update`, `projects counts`                                                                              |
| Folders              | `projects folders list`, `create`, `items`, `update`, `move`, `delete`, `bulk-move`                                                                                                    |
| Assets               | `assets list`, `library`, `search`, `semantic-search`, `get`, `projects`, `update`, `status`, `assign-agent`, `unassign`, `delete`, `delete-stack`, `move-folder`, `stack`, `versions` |
| Bulk asset transfers | `assets bulk copy-to-project`, `assets bulk move-to-project`                                                                                                                           |
| Comments             | `comments list`, `create`, `update`, `edit`, `status`, `delete`                                                                                                                        |
| Collections          | `collections list`, `create`, `get`, `update`, `items`, `delete`                                                                                                                       |
| Website review       | `screenshots create`                                                                                                                                                                   |
| Sharing              | `shares create`, `shares create-collection`, `shares list-asset`, `shares list-project`, `shares list-collection`, `shares revoke`                                                     |
| Uploads              | `upload single-file`, `complete-single`, `start`, `sign`, `sign-batch`, `complete`, `abort`                                                                                            |

Use `raw` when an endpoint exists before the CLI has a first-class command:

```bash theme={null}
reloops-cli raw PATCH api-assets/asset_123 --body '{"status":"approved"}'
```

## Authentication

Pass the developer key as a Bearer token. The CLI does this automatically when `RELOOPS_API_KEY` is set.

```bash theme={null}
curl https://api.reloops.app/functions/v1/api-workspaces \
  -H "Authorization: Bearer reloops_live_YOUR_API_KEY"
```

API keys are scoped to the organization that created them. The API only returns workspaces and assets available to that organization.