From b26905413170a22f37a61bb08bfd97baffbf8a4b Mon Sep 17 00:00:00 2001 From: Damien Berezenko Date: Sun, 1 Mar 2026 00:37:42 +0000 Subject: [PATCH] docs: update README with non-interactive mode, new MCP tools, and agent tool list --- README.md | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/README.md b/README.md index bf8a1c628..0f171df23 100644 --- a/README.md +++ b/README.md @@ -255,12 +255,23 @@ The system automatically detects and processes files for all supported languages ### Step 2: Query the Codebase +**Interactive mode:** + Start the interactive RAG CLI: ```bash python -m codebase_rag.main start --repo-path /path/to/your/repo ``` +**Non-interactive mode (single query):** + +Run a single query and exit, with output sent to stdout (useful for scripting): + +```bash +python -m codebase_rag.main start --repo-path /path/to/your/repo \ + --ask-agent "What functions call UserService.create_user?" +``` + ### Step 2.5: Real-Time Graph Updates (Optional) For active development, you can keep your knowledge graph automatically synchronized with code changes using the realtime updater. This is particularly useful when you're actively modifying code and want the AI assistant to always work with the latest codebase structure. @@ -503,6 +514,10 @@ claude mcp add --transport stdio graph-code \ - **surgical_replace_code** - Precise code edits - **read_file / write_file** - File operations - **list_directory** - Browse project structure +- **shell_command** - Execute terminal commands +- **document_analyzer** - Analyze PDFs and documents +- **semantic_search** - Find functions by intent +- **get_function_source** - Retrieve function source by ID ### Example Usage @@ -607,6 +622,9 @@ The agent has access to a suite of tools to understand and interact with the cod - **`create_new_file`**: Creates a new file with specified content. - **`replace_code_surgically`**: Surgically replaces specific code blocks in files. Requires exact target code and replacement. Only modifies the specified block, leaving rest of file unchanged. True surgical patching. - **`execute_shell_command`**: Executes a shell command in the project's environment. +- **`analyze_document`**: Analyzes PDFs and documents to answer questions about their content. +- **`semantic_search_functions`**: Finds functions by natural language intent using embeddings. +- **`get_function_source_by_id`**: Retrieves source code for a function by its node ID. ### Intelligent and Safe File Editing