{"id":50285591,"url":"https://github.com/exboys/agent-doctor","last_synced_at":"2026-06-04T08:00:32.809Z","repository":{"id":360641418,"uuid":"1251040883","full_name":"EXboys/agent-doctor","owner":"EXboys","description":"Diagnose, back up, and repair local AI agent runtimes","archived":false,"fork":false,"pushed_at":"2026-05-28T01:58:47.000Z","size":487,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-28T02:18:44.146Z","etag":null,"topics":["ai-agents","claude-code","codex","desktop-app","developer-tools","evotown","hermes-agent","llm","mcp","openclaw"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/EXboys.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":"docs/ROADMAP.md","authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-27T07:33:56.000Z","updated_at":"2026-05-28T01:59:54.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/EXboys/agent-doctor","commit_stats":null,"previous_names":["exboys/agent-desk","exboys/agent-doctor"],"tags_count":6,"template":false,"template_full_name":null,"purl":"pkg:github/EXboys/agent-doctor","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EXboys%2Fagent-doctor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EXboys%2Fagent-doctor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EXboys%2Fagent-doctor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EXboys%2Fagent-doctor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/EXboys","download_url":"https://codeload.github.com/EXboys/agent-doctor/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/EXboys%2Fagent-doctor/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33895175,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-04T02:00:06.755Z","response_time":64,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-agents","claude-code","codex","desktop-app","developer-tools","evotown","hermes-agent","llm","mcp","openclaw"],"created_at":"2026-05-28T02:02:01.087Z","updated_at":"2026-06-04T08:00:32.803Z","avatar_url":"https://github.com/EXboys.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Agent Doctor\n\n**Diagnose, repair, and onboard local AI agent runtimes on one machine.**\n\nAgent 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.\n\nUse it standalone on a developer laptop, or connect an enterprise control plane when your team needs shared gateways, skills, and policy.\n\n```bash\nagent-doctor doctor                              # Diagnose: installed runtimes, config paths, gateway wiring\nagent-doctor repair hermes                       # Repair: probes + safe preview (no writes)\nagent-doctor repair hermes --apply               # Backup, Hermes rule fixes, re-probe, audit\nagent-doctor repair hermes --rollback            # Restore latest backup (or --backup \u003cid\u003e)\nagent-doctor setup --url ... --key ...           # Onboard: apply company profile (planned)\n```\n\n[License: MIT](LICENSE) · [Roadmap](docs/ROADMAP.md) · [Repair safety](docs/repair-safety.md)\n\n---\n\n## Enterprise (optional)\n\nWith a control plane (e.g. [Evotown](https://github.com/EXboys/evotown)):\n\n```bash\nagent-doctor sync          # Pull private skill bundle (planned)\nagent-doctor policy pull   # Cache policy rules locally (planned)\n```\n\nSee [docs/enterprise.md](docs/enterprise.md).\n\n---\n\n## Status\n\n🚧 **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](docs/ROADMAP.md).\n\n**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.\n\nDiagnostic data is classified by sensitivity; secrets are redacted before AI analysis. Real writes require typed actions, backups, and confirmation — [docs/repair-safety.md](docs/repair-safety.md).\n\n---\n\n## Why Agent Doctor?\n\nDevelopers and teams increasingly run **several** local AI agent runtimes:\n\n\n| Runtime                                                       | Typical config              |\n| ------------------------------------------------------------- | --------------------------- |\n| [OpenClaw](https://github.com/openclaw/openclaw)              | `~/.openclaw/openclaw.json` |\n| [Hermes Agent](https://github.com/nousresearch/hermes-agent)  | `~/.hermes/config.yaml`     |\n| [Claude Code](https://docs.anthropic.com/en/docs/claude-code) | `~/.claude/settings.json`   |\n| Codex CLI                                                     | `~/.codex/config.toml`      |\n\n\nEach runtime has its own install path, gateway settings, skills manifest, policy surface, and failure modes. Agent Doctor gives you **one** local client to answer:\n\n- What is installed on this laptop?\n- Where do configs live?\n- Are runtimes pointed at the approved company gateway?\n- Which configs drifted away from the team profile?\n- Why did this employee's agent stop working?\n- What needs to be backed up before repair or policy remediation?\n- Can we safely restore the runtime to a compliant team baseline?\n\n```text\n  Your laptop\n ┌─────────────────────────┐\n │ Agent Doctor            │\n │ doctor · repair · setup │\n └───────────┬─────────────┘\n             │\n   OpenClaw · Hermes · Claude Code · Codex\n```\n\n---\n\n## Relationship to other tools\n\n\n| Project                                                     | Scope                                                                         |\n| ----------------------------------------------------------- | ----------------------------------------------------------------------------- |\n| **[ClawPanel](https://github.com/qingchencloud/clawpanel)** | Rich GUI for OpenClaw + Hermes                                                |\n| **[ClawPal](https://github.com/lay2dev/clawpal)**           | OpenClaw desktop config companion                                             |\n| **Agent Doctor**                                             | **Team runtime diagnosis, backup, repair, policy checks, and compliance reporting** |\n\n\n---\n\n## 中文\n\n**Agent Doctor** 在本机 **诊断、修复、就位** AI Agent Runtime（OpenClaw、Hermes、Claude Code、Codex 等）。\n\n```bash\nagent-doctor doctor                              # 诊断\nagent-doctor repair hermes                       # 修复预览（不写文件）\nagent-doctor repair hermes --apply               # 备份 + Hermes 规则修复 + 复检\nagent-doctor repair hermes --rollback            # 从备份恢复\nagent-doctor setup --url ... --key ...           # 就位（规划中）\n```\n\n企业可选：`sync`、`policy pull` — 见 [docs/enterprise.md](docs/enterprise.md)。完整中文说明：[docs/zh-CN/README.md](docs/zh-CN/README.md)。\n\n---\n\n## Development\n\n```bash\n# CLI\ncargo run -p agent-doctor -- doctor\n\n# Local CI checks (fmt / clippy / test)\nmake check\n# or: ./scripts/check.sh cli\n\n# Desktop menubar (requires Node.js)\ncd desktop \u0026\u0026 npm install \u0026\u0026 npm run tauri dev\n```\n\nSee [docs/development.md](docs/development.md), [docs/ROADMAP.md](docs/ROADMAP.md), [docs/install.md](docs/install.md), [cli/README.md](cli/README.md), [desktop/README.md](desktop/README.md), and [CONTRIBUTING.md](CONTRIBUTING.md).\n\n## Install\n\nPrebuilt CLI and desktop bundles are published to [GitHub Releases](https://github.com/EXboys/agent-doctor/releases).\n\n```bash\n# Latest CLI (pick the pattern for your OS — see docs/install.md)\ngh release download --repo EXboys/agent-doctor --pattern 'agent-doctor-*-macos-arm64.tar.gz'\ntar -xzf agent-doctor-*-macos-arm64.tar.gz \u0026\u0026 chmod +x agent-doctor\n./agent-doctor doctor\n```\n\n## License\n\nMIT — see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexboys%2Fagent-doctor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fexboys%2Fagent-doctor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fexboys%2Fagent-doctor/lists"}