diff --git a/internal/agent/tools/sourcegraph.md b/internal/agent/tools/sourcegraph.md
index 6e0e3fb7f55256491a716e0cbcb02ad567c73635..05833c5c7535859f490bd8a76cba95331e830a4f 100644
--- a/internal/agent/tools/sourcegraph.md
+++ b/internal/agent/tools/sourcegraph.md
@@ -1,4 +1,4 @@
-Search code across public repositories using Sourcegraph's GraphQL API.
+Search code across public GitHub repositories via Sourcegraph; supports regex, language/repo/file filters, and symbol search (max 20 results). Only searches public repos.
 
 <usage>
 - Provide search query using Sourcegraph syntax