jackwener avatar

Opencli Autofix

When an opencli command breaks because a website changed its DOM or API, this walks you through the fix instead of just logging the error. It collects a trace artifact with snapshots and network logs, helps you explore the live site to find what moved, patches the adapter file, retries the command, and optionally files a GitHub issue once the fix is verified. It enforces safety stops for auth and browser connection issues and caps you at three repair rounds before bailing. The trace context is especially good here since it gives you the exact adapter source path and redacted network events in a single directory. Designed for when selectors break or endpoints move, not for rate limits or soft blocks.

skills.sh installs
18K
GitHub stars
31K
last updated
Aug 21, 2026

Install

$ npx -y skills add jackwener/opencli --skill opencli-autofix --agent claude-code

Installs into .claude/skills of the current project.

Files

OpenCLI AutoFix — Automatic Adapter Self-Repair

When an opencli command fails because a website changed its DOM, API, or response schema, automatically diagnose, fix the adapter, and retry — don't just report the error.

Safety Boundaries

Before starting any repair, check these hard stops:

  • AUTH_REQUIRED (exit code 77) — STOP. Do not modify code. Tell the user to log into the site in Chrome.
  • BROWSER_CONNECT (exit code 69) — STOP. Do not modify code. Tell the user to run opencli doctor.
  • CAPTCHA / rate limiting — STOP. Not an adapter issue.

Scope constraint:

  • Only modify the file at adapterSourcePath in the trace summary.md front matter — this is the authoritative adapter location (may be clis/<site>/ in repo or ~/.opencli/clis/<site>/ for npm installs)
  • Never modify src/, extension/, tests/, package.json, or tsconfig.json

Retry budget: Max 3 repair rounds per failure. If 3 rounds of diagnose → fix → retry don't resolve it, stop and report what was tried.

Prerequisites

opencli doctor    # Verify extension + daemon connectivity

When to Use This Skill

Sponsors

Details

Repository
github.com/jackwener/opencli
Categories
Git & Pull Requests, AI & Agent Building, Debugging
First seen
Apr 16, 2026

More from jackwener/opencli

All 11
1tw93 avatarchecktw93/wazaReviews code diffs, PRs, issue queues, release readiness, commits, pushes, publishing, and project audits. Use when users ask in any language for code review, i16.4Kskills.sh installs
2linear avatarlinear-release-setuplinear/linear-releaseGenerate CI/CD configuration for Linear Release. Use when setting up release tracking, configuring CI pipelines for Linear, or integrating deployments with Line15.3Kskills.sh installs
3github avatarplaywright-automation-fill-in-formgithub/awesome-copilotAutomate filling in a form using Playwright MCP13.7Kskills.sh installs
4github avatarcreate-agentsmdgithub/awesome-copilotPrompt for generating an AGENTS.md file for a repository13.3Kskills.sh installs
5github avatardotnet-upgradegithub/awesome-copilotReady-to-use prompts for comprehensive .NET framework upgrade analysis and execution11.7Kskills.sh installs
6github avatarapple-appstore-reviewergithub/awesome-copilotServes as a reviewer of the codebase with instructions on looking for Apple App Store optimizations or rejection reasons.11.5Kskills.sh installs