Diagnose, repair, and onboard local AI agent runtimes on one machine.
Agent Doctor discovers OpenClaw, Hermes, Claude Code, Codex, and related runtimes, runs redacted probes to find misconfiguration, and repairs them with backups, typed actions, and audit reports.
Use it standalone on a developer laptop, or connect an enterprise control plane when your team needs shared gateways, skills, and policy.
agent-doctor doctor # Diagnose: installed runtimes, config paths, gateway wiring
agent-doctor repair hermes # Repair: probes + safe preview (no writes)
agent-doctor repair hermes --apply # Backup, Hermes rule fixes, re-probe, audit
agent-doctor repair hermes --rollback # Restore latest backup (or --backup <id>)
agent-doctor setup --url ... --key ... # Onboard: apply company profile (planned)License: MIT · Roadmap · Repair safety
With a control plane (e.g. Evotown):
agent-doctor sync # Pull private skill bundle (planned)
agent-doctor policy pull # Cache policy rules locally (planned)See docs/enterprise.md.
🚧 Early MVP — doctor, install, setup, Hermes-focused repair --apply, and a Tauri menubar shell. Not yet: enterprise sync/policy, full OpenClaw/Codex playbooks, or auto-filling API keys. See docs/ROADMAP.md.
Hermes repair today: backup configs; tighten .env permissions; dedupe API key env vars; fill model fields from your active profile; when the key is missing, create a .env placeholder and a local setup guide (you paste the secret). Rollback: repair hermes --rollback or the desktop Rollback from backup button.
Diagnostic data is classified by sensitivity; secrets are redacted before AI analysis. Real writes require typed actions, backups, and confirmation — docs/repair-safety.md.
Developers and teams increasingly run several local AI agent runtimes:
| Runtime | Typical config |
|---|---|
| OpenClaw | ~/.openclaw/openclaw.json |
| Hermes Agent | ~/.hermes/config.yaml |
| Claude Code | ~/.claude/settings.json |
| Codex CLI | ~/.codex/config.toml |
Each runtime has its own install path, gateway settings, skills manifest, policy surface, and failure modes. Agent Doctor gives you one local client to answer:
- What is installed on this laptop?
- Where do configs live?
- Are runtimes pointed at the approved company gateway?
- Which configs drifted away from the team profile?
- Why did this employee's agent stop working?
- What needs to be backed up before repair or policy remediation?
- Can we safely restore the runtime to a compliant team baseline?
Your laptop
┌─────────────────────────┐
│ Agent Doctor │
│ doctor · repair · setup │
└───────────┬─────────────┘
│
OpenClaw · Hermes · Claude Code · Codex
| Project | Scope |
|---|---|
| ClawPanel | Rich GUI for OpenClaw + Hermes |
| ClawPal | OpenClaw desktop config companion |
| Agent Doctor | Team runtime diagnosis, backup, repair, policy checks, and compliance reporting |
Agent Doctor 在本机 诊断、修复、就位 AI Agent Runtime（OpenClaw、Hermes、Claude Code、Codex 等）。
agent-doctor doctor # 诊断
agent-doctor repair hermes # 修复预览（不写文件）
agent-doctor repair hermes --apply # 备份 + Hermes 规则修复 + 复检
agent-doctor repair hermes --rollback # 从备份恢复
agent-doctor setup --url ... --key ... # 就位（规划中）企业可选：sync、policy pull — 见 docs/enterprise.md。完整中文说明：docs/zh-CN/README.md。
# CLI
cargo run -p agent-doctor -- doctor
# Local CI checks (fmt / clippy / test)
make check
# or: ./scripts/check.sh cli
# Desktop menubar (requires Node.js)
cd desktop && npm install && npm run tauri devSee docs/development.md, docs/ROADMAP.md, docs/install.md, cli/README.md, desktop/README.md, and CONTRIBUTING.md.
Prebuilt CLI and desktop bundles are published to GitHub Releases.
# Latest CLI (pick the pattern for your OS — see docs/install.md)
gh release download --repo EXboys/agent-doctor --pattern 'agent-doctor-*-macos-arm64.tar.gz'
tar -xzf agent-doctor-*-macos-arm64.tar.gz && chmod +x agent-doctor
./agent-doctor doctorMIT — see LICENSE.