parallel-cli-setup
Set up and maintain the Parallel CLI (install, auth, balance, skills install)
By parallel-web · 4,676 installs
npx skills add parallel-web/parallel-agent-skills --skill parallel-cli-setup
Source repository · Upstream listing
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:
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:
You will get a response like:
If authenticated is false or selected org id is legacy , prompt the user to log in:
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.
When invoking from an agent harness, prefer streaming stdout via a Monitor style tool over blocking on completion.
The output will look like:
{"event": "auth success"} is emitted only after the user has successfully authorized the CLI. Otherwise it blocks at {"event": "auth waiting"} .
Step 3: Check balance
After authentication, check the current balance:
If zero, prompt the user to add balance:
Make it clear that a payment method should have been added to the organization. If not, the user can go to <https://platform.parallel.ai/settings to add one.
Step 4: Install the Parallel skills
Install the skills for the user:
The user may need to restart their agent if it doesn't support hot reloading.
Step 5: Suggest a first run
Prompt the user to use the newly installed skills to run a search or extract right away. Suggest one of (use $ instead of / for Codex):
/parallel web search <query — fast web search
/parallel web extract <url — extract content from a URL
/parallel deep research <topic — comprehensive research
/parallel data enrichment <list — enrich a list of entities