MCP, MCP server
Agent Fix
Use when an explicitly named AI coding agent (Claude Code, Codex, OpenCode, Hermes, Kimi Code, Pi, ZCode, Cursor, Gemini CLI, ...) is broken or misconfigured: native binary missing after npm install/upgrade, GUI tools (CC-Switch) report 'installed but cannot run', Node too old, n
Compatibility: Not stated.
Grade C
One Medium finding. Read the report before installing.
Not a guarantee. A hygiene check of the source at the commit shown, not a security audit.
SECRETS_PATH_CREDENTIAL
Why this grade
- SECRETS_PATH_CREDENTIAL Medium
Mentions a credential store path (~/.ssh, id_rsa, .npmrc, .aws/credentials, credentials.json, .netrc).
fixes/agent-auth.md, line 19
2. Credential file missing/corrupt (`~/.claude/.credentials.json`,
Any High, or two or more Medium findings, give D. One Medium gives C. Low findings or a security Note give B. Each code names a finding behind the letter.
Grades are a hygiene check of the source at the commit shown, on the date checked, not a security audit or a guarantee. The free directory grades are automated. Before release, a PlugVet engineer reviews every paid report and any grade we hold back, including all F grades, against the source code and the evidence we quote.
What was checked
Plain notes from the hygiene checks.
Permissions
Concern
can delete files.
PERMISSION_DELETE_FILES
agentfix/engine.py, line 90
proc = subprocess.run(
agentfix/engine.py, line 203
npm_proxy = subprocess.run(
agentfix/engine.py, line 843
r = subprocess.run(
Show more
agentfix/hooks.py, line 245
r = subprocess.run(["hermes", "cron", *args], capture_output=True, text=True, errors="replace", timeout=timeout)
agentfix/hooks.py, line 348
r = subprocess.run(args, capture_output=True, text=True, errors="replace", timeout=60)
agentfix/hooks.py, line 690
shutil.rmtree(stage, ignore_errors=True)
agentfix/hooks.py, line 902
shutil.rmtree(target)
agentfix/state.py, line 959
shutil.rmtree(path)
mcp/smoke_test.py, line 33
proc = subprocess.run(
.github/workflows/ci.yml, line 79
assert subprocess.run([sys.executable, "scripts/fix.py", "list"], check=True).returncode == 0
.github/workflows/ci.yml, line 80
assert subprocess.run([sys.executable, "scripts/fix.py", "agents"], check=True).returncode == 0
Install and update
Note
The docs document an installer that pipes a download into a shell.
INSTALL_DOCUMENTED_INSTALLER
fixes/node-version.md, line 51
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
Network
Pass
No network call found.
Secrets
Concern
reads a credential or environment file.
SECRETS_PATH_CREDENTIAL SECRETS_PATH_DOTENV
agentfix/engine.py, line 916
_CONFIG_EXTS = {".json", ".toml", ".yaml", ".yml", ".env", ".ini", ".cfg"}
fixes/agent-auth.md, line 19
2. Credential file missing/corrupt (`~/.claude/.credentials.json`,
fixes/agent-auth.md, line 30
ls -la ~/.claude/.credentials.json 2>/dev/null || echo "no credentials file"
Show more
fixes/deepseek-provider.md, line 103
# keys go in the provider config / .env, e.g. DEEPSEEK_API_KEY=sk-...
fixes/kimi-code.md, line 11
`[providers.<name>].api_key_env`, or the documented `[providers.<name>.env]`
fixes/provider-config.md, line 57
| Hermes | provider config | `hermes config set provider <name>`, `hermes config set model <m>`; key in provider config/.env |
Agent instructions
Pass
No instruction to ignore earlier instructions or to hide a step.
Obfuscation
Pass
No encoded or minified payload found.
Licence
Pass
A licence file is present (LICENSE).
Maintainer activity
Pass
The latest commit is within the last 365 days.
Note
Hygiene check of commit db804ef4bcb3. can delete files. The docs document an installer that pipes a download into a shell. reads a credential or environment file.
Date and source
Date checked:
github.com
Commit graded: db804ef4bcb307beb4708a130ffa60c39455538f
This link goes to the original host. PlugVet does not host or check what you download from there, and installing it is your own decision and risk.