diff --git a/docs/integrations/copilot.mdx b/docs/integrations/copilot.mdx
index 8fd638f..fbf5664 100644
--- a/docs/integrations/copilot.mdx
+++ b/docs/integrations/copilot.mdx
@@ -231,8 +231,18 @@ Append the following settings to your configuration:
 ## Verify configuration
 
 To verify that you've successfully connected Copilot to CodeGate, open the
-Copilot chat and type `codegate version`. You should receive a response like
-"CodeGate version 0.1.13".
+Copilot Chat (not Copilot Edits) and type `codegate version`. You should receive
+a response like "CodeGate version 0.1.13".
+
+:::note
+
+There is a [known issue](https://github.com/stacklok/codegate/issues/1061) with
+`codegate` commands in Copilot chat if you have a file included in the context.
+Close all open files or use the eye icon in the chat input to disable the
+current file context, otherwise Copilot responds based on the file you have open
+instead of returning the command result.
+
+:::
 
 <ThemedImage
   alt='Verify Copilot integration'
diff --git a/docs/quickstart-copilot.mdx b/docs/quickstart-copilot.mdx
index 361d9a8..ee2a791 100644
--- a/docs/quickstart-copilot.mdx
+++ b/docs/quickstart-copilot.mdx
@@ -97,6 +97,16 @@ Add the following settings to your configuration:
 Enter `codegate version` in the Copilot chat to confirm that CodeGate is
 intercepting Copilot traffic. CodeGate responds with its version number.
 
+:::note
+
+There is a [known issue](https://github.com/stacklok/codegate/issues/1061) with
+`codegate` commands in Copilot chat if you have a file included in the context.
+Close all open files or use the eye icon in the chat input to disable the
+current file context, otherwise Copilot responds based on the file you have open
+instead of returning the command result.
+
+:::
+
 ## Explore CodeGate's key features
 
 To learn more about CodeGate's capabilities, clone the demo repository to a