Doctor

Diagnose an Agent-OS filesystem when setup, skills, state, links, generated runtime adapters, cloud-synced files, privacy boundaries, or Gitless behavior may be unhealthy. Use for health checks and troubleshooting, not ordinary project work.

aylee a4c9ef0 1.3 KB Updated

File contents

Agent-OS doctor

Run the deterministic checker when Python is available:

python3 library/scripts/agent_os_doctor.py --root .

Otherwise inspect the same contracts manually:

  • agent-os.yaml identity and portable/local boundary;
  • binder-to-workstream links and stable IDs;
  • workstream schema, revision lineage, size, and the next-action or closed-sentinel rule;
  • receipt metadata and relative paths;
  • stale handoffs, duplicate IDs, partial files, and provider conflict copies;
  • canonical .agents/skills plus generated Claude/Codex metadata;
  • missing skill references, PII, absolute machine paths, and adapter drift;
  • backup freshness and whether local state resolves outside the portable root.

Report evidence, severity, and the smallest safe repair. Do not repair, delete, merge conflict copies, regenerate adapters, or touch global runtime settings unless the user authorizes that action.

aylee/agent-os/tree/main/.claude/skills/doctor commit a4c9ef036d

Frequently asked questions

npx skillmds@latest add aylee/doctor-2