CLI Quickstart

Install the CLI

npm install -g @promptloop/cli

Or run without a global install:

npx @promptloop/cli --help

Authenticate

Use browser login (recommended):

promptloop auth login --browser

Or authenticate directly with an API key:

promptloop auth login --api-key YOUR_API_KEY

Verify auth status:

promptloop auth whoami

Create API keys from your PromptLoop settings page: promptloop.com/account/settings

Run your first task

List tasks:

promptloop tasks list

Run one task with inputs:

promptloop tasks run YOUR_TASK_ID --inputs "https://promptloop.com"

Run a batch job

Create a batch from a CSV or JSON file:

promptloop batches create --task-id YOUR_TASK_ID --file ./input.csv

Watch status:

promptloop batches status YOUR_BATCH_ID --watch

Fetch results:

promptloop batches results YOUR_BATCH_ID --wait

Claude quick copy

Use this as a drop-in prompt for Claude when you want it to run the same CLI workflow.

You are helping me run PromptLoop from the CLI.

1. Confirm I am authenticated:
   - promptloop auth whoami
2. List available tasks:
   - promptloop tasks list
3. Run a task:
   - promptloop tasks run YOUR_TASK_ID --inputs "https://promptloop.com"
4. Run a batch from file:
   - promptloop batches create --task-id YOUR_TASK_ID --file ./input.csv
5. Check progress:
   - promptloop batches status YOUR_BATCH_ID --watch
6. Fetch results:
   - promptloop batches results YOUR_BATCH_ID --wait

Ask me for missing IDs before executing commands.

promptloop auth whoami
promptloop tasks list
promptloop tasks run YOUR_TASK_ID --inputs "https://promptloop.com"
promptloop batches create --task-id YOUR_TASK_ID --file ./input.csv
promptloop batches status YOUR_BATCH_ID --watch
promptloop batches results YOUR_BATCH_ID --wait

Get Started

API Introduction

Install the CLI

Authenticate

Run your first task

Run a batch job

Claude quick copy

​Install the CLI

​Authenticate

​Run your first task

​Run a batch job

​Claude quick copy

Install the CLI

Authenticate

Run your first task

Run a batch job

Claude quick copy