qingzhuo-cn

Agent Fix — AI skill for Claude Code

AI community

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

How to install Agent Fix

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

What Agent Fix does

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

Alternatives in AI

Opencodex — Universal provider proxy for OpenAI Codex & Claude Code — use any LLM (Claude, Gemini, Grok, DeepSeek, Ollama… 12.3k ★
Openskills — Universal skills loader for AI coding agents - npm i -g openskills 9.8k ★
Desktop Cc Gui — Multi-engine AI coding desktop client (Tauri) 4.4k ★

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