qingzhuo-cn

Agent Fix

Name: Agent Fix
Author: qingzhuo-cn

AI community

SOURCE https://github.com/qingzhuo-cn/agent-fix

Description

Universal repair skill & CLI for AI coding agents (Claude Code, Codex, OpenCode, Hermes) — npm postinstall, GUI PATH, Node version, registry, auth, DeepSeek provider

Installation

This entry records only its repository, not the path inside it, so there is no exact command to give. Open the source below and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

README

agent-fix

**One command heals broken AI coding agents.** Claude Code, Codex, OpenCode, Hermes, Kimi Code, Pi, ZCode, Cursor — when the install or upgrade silently breaks them, `fix apply ` diagnoses, repairs, and **verifies** in a single command. No dependencies. Cross-platform.

English / [简体中文](README_cn.md)

[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE) [![Platform](https://img.shields.io/badge/platform-Windows%20%7C%20macOS%20%7C%20Linux-lightgrey.svg)]() [![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)]() [![PRs Welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)]() [![GitHub stars](https://img.shields.io/github/stars/qingzhuo-cn/agent-fix?style=social)](https://github.com/qingzhuo-cn/agent-fix)

🩺 It really looks like this

$ fix doctor
== npm-postinstall-skipped: npm postinstall skipped -> native binary missing
    [FAIL] opencode binary runs
          Error: postinstall script was not run
   -> BROKEN. Fix with: fix apply npm-postinstall-skipped --yes

$ fix apply npm-postinstall-skipped --yes
    [FIX ] Re-run opencode postinstall        → ok (12.4s)
    [FIX ] Re-run claude-code install script  → ok (1.1s)
    [VERIFY OK] opencode --version            → v1.18.10
    [VERIFY OK] claude --version              → 2.1.220 (Claude Code)
=> verified OK

$ fix doctor   # everything healthy? prints nothing
$ echo $?      # → 0

**▶ Try it in 30 seconds — no install, no dependencies:**

git clone https://github.com/qingzhuo-cn/agent-fix.git && cd agent-fix
./scripts/fix doctor   # or: powershell -File install\install.ps1 to install into your agents