From 959c957ece8aab85dcfcfb4282e06a3bcd0a3fc8 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 8 May 2026 18:15:20 +0000
Subject: [PATCH 1/2] Initial plan


From 6abc84e53a0dde3a3273ea1cdcd5048f865b83cd Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Fri, 8 May 2026 18:20:42 +0000
Subject: [PATCH 2/2] Add troubleshooting section for FrameLocalsProxy
 ValueError in README

Agent-Logs-Url: https://github.com/Azure/repair-script-library/sessions/32d38447-aa3a-411d-9394-9d41f425cc90

Co-authored-by: EdwinBernal1 <109677148+EdwinBernal1@users.noreply.github.com>
---
 README.md | 26 ++++++++++++++++++++++++++
 1 file changed, 26 insertions(+)

diff --git a/README.md b/README.md
index 4f2f784..9f36f96 100644
--- a/README.md
+++ b/README.md
@@ -44,6 +44,32 @@ az vm repair -h
 az vm repair <command> -h
 ```
 
+## Troubleshooting
+
+### `ValueError: cannot remove local variables from FrameLocalsProxy`
+
+**Symptoms:** Running any `az vm repair` command (e.g., `az vm repair create`) fails with:
+```
+ValueError: cannot remove local variables from FrameLocalsProxy
+```
+
+**Cause:** This error occurs when using Python 3.13 or later. In Python 3.13, `frame.f_locals` returns a `FrameLocalsProxy` object instead of a plain `dict`. The older version of the `vm-repair` extension attempted to delete an item directly from this proxy object, which is not supported.
+
+**Fix:** Update the `vm-repair` extension to version **2.1.3** or later:
+```
+az extension update -n vm-repair
+```
+
+If the extension is not installed yet:
+```
+az extension add -n vm-repair
+```
+
+Verify the installed version:
+```
+az extension show -n vm-repair --query version
+```
+
 # Contributing
 
 **Adding new scripts**: https://github.com/Azure/repair-script-library/blob/master/doc/adding_new_scripts.md