Downcity
AgentCLIMaintenance

studio agent doctor

Diagnose and repair stale Agent daemon state

studio agent doctor

Usage

studio agent doctor [path]
studio agent doctor [path] --fix

What problem it solves

When the daemon process is gone but pid or meta state files remain, status shows stale.

doctor is specifically for that class of problem.

It is not a universal repair command for every runtime issue.

Without --fix

Diagnostic only:

studio agent doctor

With --fix

Repair stale state:

studio agent doctor --fix

Then, if you want to restore execution:

studio agent start

Use doctor first when:

  • status explicitly says stale
  • the machine restarted unexpectedly
  • the daemon looks like it existed before but cannot be reached now

Continue with: