From 077e731ce08100231ea73f3178e8c728e495c85a Mon Sep 17 00:00:00 2001 From: Fahad Date: Mon, 9 Jun 2025 22:47:28 +0400 Subject: [PATCH] docs: reorganize README for better flow - Move example workflow image to Why This Server section - Condense File & Directory Support into single bullet point - Remove duplicate image/prompt from think_deeper section This creates a cleaner, more compelling introduction that showcases real usage before diving into setup details. Co-Authored-By: Claude --- README.md | 29 +++++++++++------------------ 1 file changed, 11 insertions(+), 18 deletions(-) diff --git a/README.md b/README.md index 6208a37..024d6ff 100644 --- a/README.md +++ b/README.md @@ -47,16 +47,21 @@ Claude is brilliant, but sometimes you need: - **Massive context window** (1M tokens) - Gemini 2.5 Pro can analyze entire codebases, read hundreds of files at once, and provide comprehensive insights ([`analyze`](#6-analyze---smart-file-analysis)) - **Deep code analysis** across massive codebases that exceed Claude's context limits ([`analyze`](#6-analyze---smart-file-analysis)) - **Dynamic collaboration** - Gemini can request additional context from Claude mid-analysis for more thorough insights +- **Smart file handling** - Automatically expands directories, filters irrelevant files, and manages token limits when analyzing `"main.py, src/, tests/"` This server makes Gemini your development sidekick, handling what Claude can't or extending what Claude starts. -## File & Directory Support +
+ +
-All tools accept both individual files and entire directories. The server: -- **Automatically expands directories** to find all code files recursively -- **Intelligently filters** hidden files, caches, and non-code files -- **Handles mixed inputs** like `"analyze main.py, src/, and tests/"` -- **Manages token limits** by loading as many files as possible within Gemini's context +**Example Workflow:** +``` +Study the code properly, think deeply about what this does and then see if there's any room for improvement in +terms of performance optimizations, brainstorm with gemini on this to get feedback and then confirm any change by +first adding a unit test with `measure` and measuring current code and then implementing the optimization and +measuring again to ensure it improved, then share results. Check with gemini in between as you make tweaks. +``` ## Quickstart (5 minutes) @@ -463,18 +468,6 @@ Combine both perspectives to create a comprehensive caching implementation guide ### 2. `think_deeper` - Extended Reasoning Partner -
- -
- -**Prompt:** -``` -Study the code properly, think deeply about what this does and then see if there's any room for improvement in -terms of performance optimizations, brainstorm with gemini on this to get feedback and then confirm any change by -first adding a unit test with `measure` and measuring current code and then implementing the optimization and -measuring again to ensure it improved, then share results. Check with gemini in between as you make tweaks. -``` - **Get a second opinion to augment Claude's own extended thinking** **Thinking Mode:** Default is `max` (32,768 tokens) for deepest analysis. Reduce to save tokens if you need faster/cheaper responses.