parallel-cli-setup

Parallel CLI Setup

Set up or maintain parallel-cli with minimal friction. If you are running this prompt, your goal is to follow the instructions below and set up parallel-cli for the user so that they can execute searches, run extracts, deep research, etc.

Step 1: Install or upgrade the CLI

Check whether the CLI exists:

command -v parallel-cli

If missing, install with any of these methods:

1. macOS only: brew install parallel-web/tap/parallel-cli
2. Linux/macOS/Windows (uv): uv tool install "parallel-web-tools[cli]"
3. Linux/macOS/Windows (npm): npm install -g parallel-web-cli
4. Linux/macOS/Windows (pipx): pipx install "parallel-web-tools[cli]" && pipx ensurepath

When parallel-cli is present, require version >=0.9.2. If older, identify the install method before advising an update. Use command -v parallel-cli, then inspect readlink "$(command -v parallel-cli)" if it is a symlink. Paths under ~/.local/share/uv/ tools/ indicate uv tool install; paths under ~/.local/share/parallel-cli/ indicate the standalone installer.

Upgrade commands (choose based on how it was installed):

• standalone: parallel-cli update
• uv: uv tool upgrade parallel-web-tools[cli]
• pipx: pipx upgrade parallel-web-tools[cli]
• npm: npm update -g parallel-web-cli
• homebrew: brew update && brew upgrade parallel-web/tap/parallel-cli

Step 2: Authenticate

Check auth status:

parallel-cli auth --json

You will get a response like:

{
  "authenticated": true,
  "method": "oauth",
  "env_var_set": false,
  "has_stored_credentials": true,
  "stored_overridden_by_env": false,
  "token_file": "xxx",
  "version": 1,
  "selected_org_id": "legacy",
  "selected_org_name": null,
  "has_control_api_tokens": false
}

If authenticated is false or selected_org_id is legacy, prompt the user to log in:

parallel-cli login --json

If this is a headless session, append --no-browser.

This triggers device OAuth. The user will be prompted to go to a web browser and input the code the CLI outputs.