Skip to content

Replace parallel skill with official parallel-cli wrapper#31

Merged
TechNickAI merged 4 commits into
mainfrom
feat/parallel-cli-wrapper
Mar 16, 2026
Merged

Replace parallel skill with official parallel-cli wrapper#31
TechNickAI merged 4 commits into
mainfrom
feat/parallel-cli-wrapper

Conversation

@TechNickAI
Copy link
Copy Markdown
Owner

Summary

  • Rewrites the parallel skill from a 262-line custom Python HTTP client to a ~40-line bash wrapper around the official parallel-cli binary
  • Auto-installs CLI on first use via parallel.ai/install.sh (cross-platform: macOS + Linux)
  • Guards against missing PARALLEL_API_KEY to prevent interactive login prompts in cron/gateway contexts
  • Adds parallel-cli to fleet machine setup specs (Brewfile, apt-packages, both compliance checks)
  • SKILL.md rewritten with comprehensive command reference covering all 6 commands: search, extract, research, enrich, findall, monitor

New capabilities (via parallel-cli)

Command What it adds
research Deep multi-source research with processor tiers (lite → ultra)
enrich AI-powered CSV/JSON data enrichment
findall Entity discovery ("find all YC companies in dev tools")
monitor Web change tracking with webhooks

Files changed

File Change
skills/parallel/parallel Python → bash wrapper with auto-install + API key guard
skills/parallel/SKILL.md v0.3.0 — full command reference with decision table
tests/test_parallel.py Rewritten for wrapper behavior
Brewfile Added parallel-web/tap/parallel-cli
devops/apt-packages.txt Added install comment (not in apt)
devops/machine-setup.md Added Parallel CLI section + compliance check
devops/machine-setup-linux.md Added Parallel CLI section + compliance check
README.md Updated version badge + skill description
VERSION 0.14.0 → 0.15.0

Test plan

  • All 7 tests pass (4 unit + 3 integration with real API calls)
  • Verified search returns structured JSON results
  • Verified extract handles URLs correctly
  • Verified API key guard fails fast with clear error
  • Verified --version/--help work without API key
  • Deploy to fleet via /fleet and verify parallel-cli --version on all machines

🤖 Generated with Claude Code

Nick Sullivan and others added 2 commits March 15, 2026 15:07
Rewrites the parallel skill from a 262-line Python HTTP client to a thin
bash wrapper around the official parallel-cli binary. The wrapper
auto-installs the CLI on first use and guards against missing API keys
to prevent interactive prompts in automated contexts.

New capabilities via parallel-cli: deep research with processor tiers,
CSV/JSON data enrichment, entity discovery (findall), and web change
monitoring — on top of the existing search and extract.

Fleet-wide changes:
- Added parallel-cli to Brewfile (macOS) and install instructions (Linux)
- Added verification to both machine setup compliance checks
- Cross-platform installer (parallel.ai/install.sh) as canonical method
- SKILL.md rewritten with comprehensive command reference and decision table

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0ccf3389f0

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread skills/parallel/parallel Outdated
Comment on lines +31 to +35
if [[ -x "$HOME/.local/bin/parallel-cli" ]]; then
export PATH="$HOME/.local/bin:$PATH"
else
install_parallel_cli
fi
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1 Badge Check API key before running auto-install path

The wrapper attempts install_parallel_cli before it validates PARALLEL_API_KEY, so on fresh machines without parallel-cli a call like parallel search ... with no key takes the network install path first instead of failing fast with the missing-key error. In cron/gateway contexts this defeats the stated non-interactive guard and can block/fail for installation reasons unrelated to auth, which is a regression from the previous implementation that errored on missing key immediately.

Useful? React with 👍 / 👎.

Comment thread skills/parallel/parallel
Comment on lines +39 to +42
case "${1:-}" in
--version|--help|-h|help) ;;
*)
if [[ -z "${PARALLEL_API_KEY:-}" ]]; then
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P2 Badge Allow no-arg invocation to show help without API key

The key gate only exempts explicit help/version tokens, so an empty invocation (parallel) falls into the default branch and requires PARALLEL_API_KEY. This regresses the prior behavior where no args showed help, and now users without a key cannot discover usage unless they already know to run help or --help.

Useful? React with 👍 / 👎.

Nick Sullivan and others added 2 commits March 15, 2026 15:11
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
- Move API key check before parallel-cli install check so missing
  key fails fast without triggering network install on fresh machines
- Add empty invocation to help bypass (no args shows CLI help)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@TechNickAI TechNickAI merged commit 2241288 into main Mar 16, 2026
6 checks passed
@TechNickAI TechNickAI deleted the feat/parallel-cli-wrapper branch March 16, 2026 01:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant