Skip to content
ReplicaMD

Reference

Troubleshooting

Diagnose repository, runtime, session, and local data problems safely.

Start with visible state

Confirm the active workspace, selected agent, worktree path, runtime, and session state before changing files. Preserve logs and avoid deleting workspace metadata as a first response.

  • Inspect the active workspace
  • Check Git status
  • Verify provider authentication
  • Review session logs

Protect local data

Back up the workspace before manual repair. Notes and Git repositories remain useful outside ReplicaMD and should never require destructive recovery for ordinary UI failures.