Skip to content

docs(update): correct doctor read-only and backend verification guidance #580

Description

@edrlu

Problem

docs/update.md says text-mode agent-reach doctor installs or preserves Agent Reach skills and implies every multi-backend channel reports an active backend.

On current main (1221ecd), _cmd_doctor() uses Config(read_only=True) and never calls _install_skill(). Some login-backed channels intentionally return active_backend: null because Doctor avoids implicit credential or browser-session probes.

Proposed fix

  • describe Doctor as read-only
  • keep skill refresh explicit with agent-reach skill --install
  • explain that active_backend is only populated after verification and may safely be null
  • add a small documentation regression test

Environment

  • macOS
  • Python 3.12
  • Agent Reach main at 1221ecd

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions