diff --git a/internal/agent/tools/crush_logs.md b/internal/agent/tools/crush_logs.md
index db67cf067c55f0a5982e27e5946c329111d4c7a8..918c4505849b3caaf8eb5c1799f1a2b5b67db9b7 100644
--- a/internal/agent/tools/crush_logs.md
+++ b/internal/agent/tools/crush_logs.md
@@ -1,4 +1,4 @@
-Read Crush's own application logs.
+Read Crush's internal application logs (default 50 entries, max 100); useful for diagnosing provider errors, tool failures, LSP/MCP issues.
 
 <usage>
 - Returns recent log entries from Crush's internal log file