skydeckai-code 0.1.39__tar.gz → 0.1.40__tar.gz

{skydeckai_code-0.1.39 → skydeckai_code-0.1.40}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: skydeckai-code
-Version: 0.1.39
+Version: 0.1.40
 Summary: This MCP server provides a comprehensive set of tools for AI-driven Development workflows including file operations, code analysis, multi-language execution, web content fetching with HTML-to-markdown conversion, multi-engine web search, code content searching, and system information retrieval.
 Project-URL: Homepage, https://github.com/skydeckai/skydeckai-code
 Project-URL: Repository, https://github.com/skydeckai/skydeckai-code
@@ -43,13 +43,13 @@ An MCP server that provides a comprehensive set of tools for AI-driven developme
 
 This mcp server was formerly known as `mcp-server-aidd`. It was renamed to `skydeckai-code` to credit the team at [SkyDeck.ai](https://skydeck.ai) with creating this application along with [East Agile](https://eastagile.com). But more importantly we realized that the term AI Driven Development (AIDD) was just not catching on. People did not understand at a glance what it was about. And nor did LLMs. "Code" was far more intuitive. And linguistically intuitive is important in the world of agentic AI.
 
-<a href="https://glama.ai/mcp/servers/mpixtij6se"><img width="380" height="200" src="https://glama.ai/mcp/servers/mpixtij6se/badge" alt="AiDD Server MCP server" /></a>
+[![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/fe7a40fd-30c1-4767-84f9-d33bf997497e)
 
 ## Installation
 
 ```bash
-# Using pip
-pip install skydeckai-code
+# Using uvx
+uvx skydeckai-code
 ```
 
 ## Claude Desktop Setup
@@ -69,9 +69,9 @@ Add to your `claude_desktop_config.json`:
 
 ## SkyDeck AI Helper App
 
-If you're using SkyDeck AI Helper app, you can search for "SkyDeckAI Code" and install it.
+If you're using MseeP AI Helper app, you can search for "SkyDeckAI Code" and install it.
 
-![SkyDeck AI Helper App](/screenshots/skydeck_ai_helper.png)
+![MseeP AI Helper App](/screenshots/mseep_ai_helper.png)
 
 ## Key Features
 
@@ -131,34 +131,6 @@ If you're using SkyDeck AI Helper app, you can search for "SkyDeckAI Code" and i
 | delete_file   | path: string                                               | Success confirmation                          |
 | get_file_info | path: string                                               | File metadata (size, timestamps, permissions) |
 
-**CLI Usage:**
-
-```bash
-# Read entire file
-skydeckai-code-cli --tool read_file --args '{"files": [{"path": "src/main.py"}]}'
-
-# Read 10 lines starting from line 20
-skydeckai-code-cli --tool read_file --args '{"files": [{"path": "src/main.py", "offset": 20, "limit": 10}]}'
-
-# Read from line 50 to the end of the file
-skydeckai-code-cli --tool read_file --args '{"files": [{"path": "src/main.py", "offset": 50}]}'
-
-# Read multiple files with different line ranges
-skydeckai-code-cli --tool read_file --args '{"files": [
-  {"path": "src/main.py", "offset": 1, "limit": 10},
-  {"path": "README.md"}
-]}'
-
-# Write file
-skydeckai-code-cli --tool write_file --args '{"path": "output.txt", "content": "Hello World"}'
-
-# Copy file or directory
-skydeckai-code-cli --tool copy_file --args '{"source": "config.json", "destination": "config.backup.json"}'
-
-# Get file info
-skydeckai-code-cli --tool get_file_info --args '{"path": "src/main.py"}'
-```
-
 ### Complex File Operations
 
 #### edit_file
@@ -208,16 +180,6 @@ Generates complete directory structure:
 
 Returns: JSON tree structure of directory contents.
 
-**CLI Usage:**
-
-```bash
-# List directory
-skydeckai-code-cli --tool list_directory --args '{"path": "."}'
-
-# Search for Python files
-skydeckai-code-cli --tool search_files --args '{"pattern": ".py", "path": "src"}'
-```
-
 ### Code Analysis
 
 #### codebase_mapper
@@ -252,19 +214,6 @@ Supported Languages:
 -   C# (.cs)
 -   Kotlin (.kt, .kts)
 
-**CLI Usage:**
-
-```bash
-# Map the entire codebase structure
-skydeckai-code-cli --tool codebase_mapper --args '{"path": "."}'
-
-# Map only the source directory
-skydeckai-code-cli --tool codebase_mapper --args '{"path": "src"}'
-
-# Map a specific component or module
-skydeckai-code-cli --tool codebase_mapper --args '{"path": "src/components"}'
-```
-
 #### search_code
 
 Fast content search tool using regular expressions:
@@ -295,29 +244,6 @@ Matching lines grouped by file with line numbers, sorted by file modification ti
 
 This tool uses ripgrep when available for optimal performance, with a Python fallback implementation. It's ideal for finding specific code patterns like function declarations, imports, variable usages, or error handling.
 
-**CLI Usage:**
-
-```bash
-# Find function and class declarations in JavaScript files
-skydeckai-code-cli --tool search_code --args '{
-    "patterns": ["function\\s+\\w+", "class\\s+\\w+"],
-    "include": "*.js"
-}'
-
-# Find all console.log statements with errors or warnings
-skydeckai-code-cli --tool search_code --args '{
-    "patterns": ["console\\.log.*[eE]rror", "console\\.log.*[wW]arning"],
-    "path": "src"
-}'
-
-# Find import and export statements in TypeScript files
-skydeckai-code-cli --tool search_code --args '{
-    "patterns": ["import.*from", "export.*"],
-    "include": "*.{ts,tsx}",
-    "exclude": "node_modules/**"
-}'
-```
-
 ### System Information
 
 | Tool            | Parameters | Returns                      |
@@ -348,13 +274,6 @@ Returns:
 
 Provides essential system information in a clean, readable format.
 
-**CLI Usage:**
-
-```bash
-# Get system information
-skydeckai-code-cli --tool get_system_info
-```
-
 ### Screen Context and Image Tools
 
 #### get_active_apps
@@ -518,28 +437,6 @@ Response content as text with HTTP status code and size information. For binary
 
 This tool can be used to access web APIs, fetch documentation, or download content from the web while respecting size limits (10MB max) and security constraints.
 
-**CLI Usage:**
-
-```bash
-# Fetch JSON from an API
-skydeckai-code-cli --tool web_fetch --args '{
-    "url": "https://api.github.com/users/octocat",
-    "headers": {"Accept": "application/json"}
-}'
-
-# Download content to a file
-skydeckai-code-cli --tool web_fetch --args '{
-    "url": "https://github.com/github/github-mcp-server/blob/main/README.md",
-    "save_to_file": "downloads/readme.md"
-}'
-
-# Fetch a webpage and convert to markdown for better readability
-skydeckai-code-cli --tool web_fetch --args '{
-    "url": "https://example.com",
-    "convert_html_to_markdown": true
-}'
-```
-
 #### web_search
 
 Performs a robust web search using multiple search engines and returns concise, relevant results.
@@ -566,27 +463,6 @@ A list of search results formatted in markdown, including titles, URLs, and snip
 
 This tool uses a multi-engine approach that tries different search engines with various parsing strategies to ensure reliable results. You can specify a preferred engine, but some engines may block automated access, in which case the tool will fall back to alternative engines when "auto" is selected.
 
-**CLI Usage:**
-
-```bash
-# Search with default settings (auto engine selection)
-skydeckai-code-cli --tool web_search --args '{
-    "query": "latest python release features"
-}'
-
-# Try DuckDuckGo if you want alternative results
-skydeckai-code-cli --tool web_search --args '{
-    "query": "machine learning frameworks comparison",
-    "search_engine": "duckduckgo"
-}'
-
-# Use Bing for reliable results
-skydeckai-code-cli --tool web_search --args '{
-    "query": "best programming practices 2023",
-    "search_engine": "bing"
-}'
-```
-
 ### Utility Tools
 
 #### batch_tools
@@ -640,47 +516,6 @@ This tool provides efficient execution of multiple operations in a single reques
 1. Use paths relative to the current working directory (e.g., "project/src" rather than just "src"), or
 2. Include an explicit tool invocation to change directories using `update_allowed_directory`
 
-**CLI Usage:**
-
-```bash
-# Setup a new project with multiple steps in sequential order (using proper paths)
-skydeckai-code-cli --tool batch_tools --args '{
-    "description": "Setup new project",
-    "sequential": true,
-    "invocations": [
-        {"tool": "create_directory", "arguments": {"path": "project"}},
-        {"tool": "create_directory", "arguments": {"path": "project/src"}},
-        {"tool": "write_file", "arguments": {"path": "project/README.md", "content": "# Project\n\nA new project."}}
-    ]
-}'
-
-# Create nested structure using relative paths (without changing directory)
-skydeckai-code-cli --tool batch_tools --args '{
-    "description": "Create project structure",
-    "sequential": true,
-    "invocations": [
-        {"tool": "create_directory", "arguments": {"path": "project/src"}},
-        {"tool": "create_directory", "arguments": {"path": "project/docs"}},
-        {"tool": "write_file", "arguments": {"path": "project/README.md", "content": "# Project"}}
-    ]
-}'
-
-# Gather system information and take a screenshot (tasks can run in parallel)
-skydeckai-code-cli --tool batch_tools --args '{
-    "description": "System diagnostics",
-    "sequential": false,
-    "invocations": [
-        {"tool": "get_system_info", "arguments": {}},
-        {"tool": "capture_screenshot", "arguments": {
-            "output_path": "diagnostics/screen.png",
-            "capture_mode": {
-                "type": "full"
-            }
-        }}
-    ]
-}'
-```
-
 #### think
 
 A tool for complex reasoning and brainstorming without making changes to the repository.
@@ -701,20 +536,6 @@ Your thoughts formatted as markdown, with a note indicating this was a thinking
 
 This tool is useful for thinking through complex problems, brainstorming solutions, or laying out implementation plans without making any actual changes. It's a great way to document your reasoning process, evaluate different approaches, or plan out a multi-step strategy before taking action.
 
-**CLI Usage:**
-
-```bash
-# Analyze a bug and plan a fix
-skydeckai-code-cli --tool think --args '{
-    "thought": "# Bug Analysis\n\n## Observed Behavior\nThe login endpoint returns a 500 error when email contains Unicode characters.\n\n## Root Cause\nThe database adapter is not properly encoding Unicode strings before constructing the SQL query.\n\n## Potential Fixes\n1. Update the database adapter to use parameterized queries\n2. Add input validation to reject Unicode in emails\n3. Encode email input manually before database operations\n\nFix #1 is the best approach as it solves the core issue and improves security."
-}'
-
-# Evaluate design alternatives
-skydeckai-code-cli --tool think --args '{
-    "thought": "# API Design Options\n\n## REST vs GraphQL\nFor this use case, GraphQL would provide more flexible data fetching but adds complexity. REST is simpler and sufficient for our current needs.\n\n## Authentication Methods\nJWT-based authentication offers stateless operation and better scalability compared to session-based auth.\n\nRecommendation: Use REST with JWT authentication for the initial implementation."
-}'
-```
-
 ### Code Execution
 
 #### execute_code
@@ -745,34 +566,6 @@ Executes code in various programming languages with safety measures and restrict
 | code | string | Yes | Code to execute |
 | timeout | integer | No | Maximum execution time (default: 5s) |
 
-**CLI Usage:**
-
-```bash
-# Python example
-skydeckai-code-cli --tool execute_code --args '{
-    "language": "python",
-    "code": "print(sum(range(10)))"
-}'
-
-# JavaScript example
-skydeckai-code-cli --tool execute_code --args '{
-    "language": "javascript",
-    "code": "console.log(Array.from({length: 5}, (_, i) => i*2))"
-}'
-
-# Ruby example
-skydeckai-code-cli --tool execute_code --args '{
-    "language": "ruby",
-    "code": "puts (1..5).reduce(:+)"
-}'
-
-# Go example
-skydeckai-code-cli --tool execute_code --args '{
-    "language": "go",
-    "code": "fmt.Println(\"Hello, Go!\")"
-}'
-```
-
 **Requirements:**
 
 -   Respective language runtimes must be installed
@@ -805,25 +598,6 @@ Executes shell scripts (bash/sh) with safety measures and restrictions.
 | script | string | Yes | Shell script to execute |
 | timeout | integer | No | Maximum execution time (default: 300s, max: 600s) |
 
-**CLI Usage:**
-
-```bash
-# List directory contents with details
-skydeckai-code-cli --tool execute_shell_script --args '{
-    "script": "ls -la"
-}'
-
-# Find all Python files recursively
-skydeckai-code-cli --tool execute_shell_script --args '{
-    "script": "find . -name \"*.py\" -type f"
-}'
-
-# Complex script with multiple commands
-skydeckai-code-cli --tool execute_shell_script --args '{
-    "script": "echo \"System Info:\" && uname -a && echo \"\nDisk Usage:\" && df -h"
-}'
-```
-
 **Features:**
 
 -   Uses /bin/sh for maximum compatibility across systems
@@ -850,20 +624,6 @@ Configuration file: `~/.skydeckai_code/config.json`
 }
 ```
 
-## CLI Usage
-
-Basic command structure:
-
-```bash
-skydeckai-code-cli --tool <tool_name> --args '<json_arguments>'
-
-# List available tools
-skydeckai-code-cli --list-tools
-
-# Enable debug output
-skydeckai-code-cli --debug --tool <tool_name> --args '<json_arguments>'
-```
-
 ## Debugging
 
 Use MCP Inspector for debugging:

{skydeckai_code-0.1.39 → skydeckai_code-0.1.40}/README.md

@@ -8,13 +8,13 @@ An MCP server that provides a comprehensive set of tools for AI-driven developme
 
 This mcp server was formerly known as `mcp-server-aidd`. It was renamed to `skydeckai-code` to credit the team at [SkyDeck.ai](https://skydeck.ai) with creating this application along with [East Agile](https://eastagile.com). But more importantly we realized that the term AI Driven Development (AIDD) was just not catching on. People did not understand at a glance what it was about. And nor did LLMs. "Code" was far more intuitive. And linguistically intuitive is important in the world of agentic AI.
 
-<a href="https://glama.ai/mcp/servers/mpixtij6se"><img width="380" height="200" src="https://glama.ai/mcp/servers/mpixtij6se/badge" alt="AiDD Server MCP server" /></a>
+[![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/fe7a40fd-30c1-4767-84f9-d33bf997497e)
 
 ## Installation
 
 ```bash
-# Using pip
-pip install skydeckai-code
+# Using uvx
+uvx skydeckai-code
 ```
 
 ## Claude Desktop Setup
@@ -34,9 +34,9 @@ Add to your `claude_desktop_config.json`:
 
 ## SkyDeck AI Helper App
 
-If you're using SkyDeck AI Helper app, you can search for "SkyDeckAI Code" and install it.
+If you're using MseeP AI Helper app, you can search for "SkyDeckAI Code" and install it.
 
-![SkyDeck AI Helper App](/screenshots/skydeck_ai_helper.png)
+![MseeP AI Helper App](/screenshots/mseep_ai_helper.png)
 
 ## Key Features
 
@@ -96,34 +96,6 @@ If you're using SkyDeck AI Helper app, you can search for "SkyDeckAI Code" and i
 | delete_file   | path: string                                               | Success confirmation                          |
 | get_file_info | path: string                                               | File metadata (size, timestamps, permissions) |
 
-**CLI Usage:**
-
-```bash
-# Read entire file
-skydeckai-code-cli --tool read_file --args '{"files": [{"path": "src/main.py"}]}'
-
-# Read 10 lines starting from line 20
-skydeckai-code-cli --tool read_file --args '{"files": [{"path": "src/main.py", "offset": 20, "limit": 10}]}'
-
-# Read from line 50 to the end of the file
-skydeckai-code-cli --tool read_file --args '{"files": [{"path": "src/main.py", "offset": 50}]}'
-
-# Read multiple files with different line ranges
-skydeckai-code-cli --tool read_file --args '{"files": [
-  {"path": "src/main.py", "offset": 1, "limit": 10},
-  {"path": "README.md"}
-]}'
-
-# Write file
-skydeckai-code-cli --tool write_file --args '{"path": "output.txt", "content": "Hello World"}'
-
-# Copy file or directory
-skydeckai-code-cli --tool copy_file --args '{"source": "config.json", "destination": "config.backup.json"}'
-
-# Get file info
-skydeckai-code-cli --tool get_file_info --args '{"path": "src/main.py"}'
-```
-
 ### Complex File Operations
 
 #### edit_file
@@ -173,16 +145,6 @@ Generates complete directory structure:
 
 Returns: JSON tree structure of directory contents.
 
-**CLI Usage:**
-
-```bash
-# List directory
-skydeckai-code-cli --tool list_directory --args '{"path": "."}'
-
-# Search for Python files
-skydeckai-code-cli --tool search_files --args '{"pattern": ".py", "path": "src"}'
-```
-
 ### Code Analysis
 
 #### codebase_mapper
@@ -217,19 +179,6 @@ Supported Languages:
 -   C# (.cs)
 -   Kotlin (.kt, .kts)
 
-**CLI Usage:**
-
-```bash
-# Map the entire codebase structure
-skydeckai-code-cli --tool codebase_mapper --args '{"path": "."}'
-
-# Map only the source directory
-skydeckai-code-cli --tool codebase_mapper --args '{"path": "src"}'
-
-# Map a specific component or module
-skydeckai-code-cli --tool codebase_mapper --args '{"path": "src/components"}'
-```
-
 #### search_code
 
 Fast content search tool using regular expressions:
@@ -260,29 +209,6 @@ Matching lines grouped by file with line numbers, sorted by file modification ti
 
 This tool uses ripgrep when available for optimal performance, with a Python fallback implementation. It's ideal for finding specific code patterns like function declarations, imports, variable usages, or error handling.
 
-**CLI Usage:**
-
-```bash
-# Find function and class declarations in JavaScript files
-skydeckai-code-cli --tool search_code --args '{
-    "patterns": ["function\\s+\\w+", "class\\s+\\w+"],
-    "include": "*.js"
-}'
-
-# Find all console.log statements with errors or warnings
-skydeckai-code-cli --tool search_code --args '{
-    "patterns": ["console\\.log.*[eE]rror", "console\\.log.*[wW]arning"],
-    "path": "src"
-}'
-
-# Find import and export statements in TypeScript files
-skydeckai-code-cli --tool search_code --args '{
-    "patterns": ["import.*from", "export.*"],
-    "include": "*.{ts,tsx}",
-    "exclude": "node_modules/**"
-}'
-```
-
 ### System Information
 
 | Tool            | Parameters | Returns                      |
@@ -313,13 +239,6 @@ Returns:
 
 Provides essential system information in a clean, readable format.
 
-**CLI Usage:**
-
-```bash
-# Get system information
-skydeckai-code-cli --tool get_system_info
-```
-
 ### Screen Context and Image Tools
 
 #### get_active_apps
@@ -483,28 +402,6 @@ Response content as text with HTTP status code and size information. For binary
 
 This tool can be used to access web APIs, fetch documentation, or download content from the web while respecting size limits (10MB max) and security constraints.
 
-**CLI Usage:**
-
-```bash
-# Fetch JSON from an API
-skydeckai-code-cli --tool web_fetch --args '{
-    "url": "https://api.github.com/users/octocat",
-    "headers": {"Accept": "application/json"}
-}'
-
-# Download content to a file
-skydeckai-code-cli --tool web_fetch --args '{
-    "url": "https://github.com/github/github-mcp-server/blob/main/README.md",
-    "save_to_file": "downloads/readme.md"
-}'
-
-# Fetch a webpage and convert to markdown for better readability
-skydeckai-code-cli --tool web_fetch --args '{
-    "url": "https://example.com",
-    "convert_html_to_markdown": true
-}'
-```
-
 #### web_search
 
 Performs a robust web search using multiple search engines and returns concise, relevant results.
@@ -531,27 +428,6 @@ A list of search results formatted in markdown, including titles, URLs, and snip
 
 This tool uses a multi-engine approach that tries different search engines with various parsing strategies to ensure reliable results. You can specify a preferred engine, but some engines may block automated access, in which case the tool will fall back to alternative engines when "auto" is selected.
 
-**CLI Usage:**
-
-```bash
-# Search with default settings (auto engine selection)
-skydeckai-code-cli --tool web_search --args '{
-    "query": "latest python release features"
-}'
-
-# Try DuckDuckGo if you want alternative results
-skydeckai-code-cli --tool web_search --args '{
-    "query": "machine learning frameworks comparison",
-    "search_engine": "duckduckgo"
-}'
-
-# Use Bing for reliable results
-skydeckai-code-cli --tool web_search --args '{
-    "query": "best programming practices 2023",
-    "search_engine": "bing"
-}'
-```
-
 ### Utility Tools
 
 #### batch_tools
@@ -605,47 +481,6 @@ This tool provides efficient execution of multiple operations in a single reques
 1. Use paths relative to the current working directory (e.g., "project/src" rather than just "src"), or
 2. Include an explicit tool invocation to change directories using `update_allowed_directory`
 
-**CLI Usage:**
-
-```bash
-# Setup a new project with multiple steps in sequential order (using proper paths)
-skydeckai-code-cli --tool batch_tools --args '{
-    "description": "Setup new project",
-    "sequential": true,
-    "invocations": [
-        {"tool": "create_directory", "arguments": {"path": "project"}},
-        {"tool": "create_directory", "arguments": {"path": "project/src"}},
-        {"tool": "write_file", "arguments": {"path": "project/README.md", "content": "# Project\n\nA new project."}}
-    ]
-}'
-
-# Create nested structure using relative paths (without changing directory)
-skydeckai-code-cli --tool batch_tools --args '{
-    "description": "Create project structure",
-    "sequential": true,
-    "invocations": [
-        {"tool": "create_directory", "arguments": {"path": "project/src"}},
-        {"tool": "create_directory", "arguments": {"path": "project/docs"}},
-        {"tool": "write_file", "arguments": {"path": "project/README.md", "content": "# Project"}}
-    ]
-}'
-
-# Gather system information and take a screenshot (tasks can run in parallel)
-skydeckai-code-cli --tool batch_tools --args '{
-    "description": "System diagnostics",
-    "sequential": false,
-    "invocations": [
-        {"tool": "get_system_info", "arguments": {}},
-        {"tool": "capture_screenshot", "arguments": {
-            "output_path": "diagnostics/screen.png",
-            "capture_mode": {
-                "type": "full"
-            }
-        }}
-    ]
-}'
-```
-
 #### think
 
 A tool for complex reasoning and brainstorming without making changes to the repository.
@@ -666,20 +501,6 @@ Your thoughts formatted as markdown, with a note indicating this was a thinking
 
 This tool is useful for thinking through complex problems, brainstorming solutions, or laying out implementation plans without making any actual changes. It's a great way to document your reasoning process, evaluate different approaches, or plan out a multi-step strategy before taking action.
 
-**CLI Usage:**
-
-```bash
-# Analyze a bug and plan a fix
-skydeckai-code-cli --tool think --args '{
-    "thought": "# Bug Analysis\n\n## Observed Behavior\nThe login endpoint returns a 500 error when email contains Unicode characters.\n\n## Root Cause\nThe database adapter is not properly encoding Unicode strings before constructing the SQL query.\n\n## Potential Fixes\n1. Update the database adapter to use parameterized queries\n2. Add input validation to reject Unicode in emails\n3. Encode email input manually before database operations\n\nFix #1 is the best approach as it solves the core issue and improves security."
-}'
-
-# Evaluate design alternatives
-skydeckai-code-cli --tool think --args '{
-    "thought": "# API Design Options\n\n## REST vs GraphQL\nFor this use case, GraphQL would provide more flexible data fetching but adds complexity. REST is simpler and sufficient for our current needs.\n\n## Authentication Methods\nJWT-based authentication offers stateless operation and better scalability compared to session-based auth.\n\nRecommendation: Use REST with JWT authentication for the initial implementation."
-}'
-```
-
 ### Code Execution
 
 #### execute_code
@@ -710,34 +531,6 @@ Executes code in various programming languages with safety measures and restrict
 | code | string | Yes | Code to execute |
 | timeout | integer | No | Maximum execution time (default: 5s) |
 
-**CLI Usage:**
-
-```bash
-# Python example
-skydeckai-code-cli --tool execute_code --args '{
-    "language": "python",
-    "code": "print(sum(range(10)))"
-}'
-
-# JavaScript example
-skydeckai-code-cli --tool execute_code --args '{
-    "language": "javascript",
-    "code": "console.log(Array.from({length: 5}, (_, i) => i*2))"
-}'
-
-# Ruby example
-skydeckai-code-cli --tool execute_code --args '{
-    "language": "ruby",
-    "code": "puts (1..5).reduce(:+)"
-}'
-
-# Go example
-skydeckai-code-cli --tool execute_code --args '{
-    "language": "go",
-    "code": "fmt.Println(\"Hello, Go!\")"
-}'
-```
-
 **Requirements:**
 
 -   Respective language runtimes must be installed
@@ -770,25 +563,6 @@ Executes shell scripts (bash/sh) with safety measures and restrictions.
 | script | string | Yes | Shell script to execute |
 | timeout | integer | No | Maximum execution time (default: 300s, max: 600s) |
 
-**CLI Usage:**
-
-```bash
-# List directory contents with details
-skydeckai-code-cli --tool execute_shell_script --args '{
-    "script": "ls -la"
-}'
-
-# Find all Python files recursively
-skydeckai-code-cli --tool execute_shell_script --args '{
-    "script": "find . -name \"*.py\" -type f"
-}'
-
-# Complex script with multiple commands
-skydeckai-code-cli --tool execute_shell_script --args '{
-    "script": "echo \"System Info:\" && uname -a && echo \"\nDisk Usage:\" && df -h"
-}'
-```
-
 **Features:**
 
 -   Uses /bin/sh for maximum compatibility across systems
@@ -815,20 +589,6 @@ Configuration file: `~/.skydeckai_code/config.json`
 }
 ```
 
-## CLI Usage
-
-Basic command structure:
-
-```bash
-skydeckai-code-cli --tool <tool_name> --args '<json_arguments>'
-
-# List available tools
-skydeckai-code-cli --list-tools
-
-# Enable debug output
-skydeckai-code-cli --debug --tool <tool_name> --args '<json_arguments>'
-```
-
 ## Debugging
 
 Use MCP Inspector for debugging:

{skydeckai_code-0.1.39 → skydeckai_code-0.1.40}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "skydeckai-code"
-version = "0.1.39"
+version = "0.1.40"
 description = "This MCP server provides a comprehensive set of tools for AI-driven Development workflows including file operations, code analysis, multi-language execution, web content fetching with HTML-to-markdown conversion, multi-engine web search, code content searching, and system information retrieval."
 readme = "README.md"
 requires-python = ">=3.11"

{skydeckai_code-0.1.39 → skydeckai_code-0.1.40}/src/aidd/tools/file_tools.py

@@ -232,11 +232,15 @@ def edit_file_tool():
         "description": "Make line-based edits to a text file. "
             "WHEN TO USE: When you need to make selective changes to specific parts of a file while preserving the rest of the content. "
             "Useful for modifying configuration values, updating text while maintaining file structure, or making targeted code changes. "
+            "IMPORTANT: For multiple edits to the same file, use a single tool call with multiple edits in the 'edits' array rather than multiple tool calls. "
+            "This is more efficient and ensures all edits are applied atomically. "
             "WHEN NOT TO USE: When you want to completely replace a file's contents (use write_file instead), when you need to create a new file (use write_file instead), "
             "or when you want to apply highly complex edits with context. "
             "RETURNS: A git-style diff showing the changes made, along with information about any failed matches. "
             "The response includes sections for failed matches (if any) and the unified diff output. "
-            "Always use dryRun first to preview changes before applying them. Only works within the allowed directory.",
+            "Only works within the allowed directory. "
+            "EXAMPLES: For a single edit: {\"path\": \"config.js\", \"edits\": [{\"oldText\": \"port: 3000\", \"newText\": \"port: 8080\"}]}. "
+            "For multiple edits: {\"path\": \"app.py\", \"edits\": [{\"oldText\": \"debug=False\", \"newText\": \"debug=True\"}, {\"oldText\": \"version='1.0'\", \"newText\": \"version='2.0'\"}]}",
         "inputSchema": {
             "type": "object",
             "properties": {
@@ -260,20 +264,26 @@ def edit_file_tool():
                         },
                         "required": ["oldText", "newText"]
                     },
-                    "description": "List of edit operations to perform on the file. Each edit specifies text to find (oldText) and text to replace it with (newText). The edits are applied in sequence, and each one can modify the result of previous edits."
-                },
-                "dryRun": {
-                    "type": "boolean",
-                    "description": "Preview changes without applying them to the file. Set to true to see what changes would be made without actually modifying the file. Highly recommended before making actual changes.",
-                    "default": False
+                    "description": "MUST be an array of edit objects, NOT a string. Each edit object must contain 'oldText' and 'newText' properties. "
+                                   "For multiple edits, use: [{\"oldText\": \"text1\", \"newText\": \"replacement1\"}, {\"oldText\": \"text2\", \"newText\": \"replacement2\"}]. "
+                                   "For single edit, still use array: [{\"oldText\": \"text\", \"newText\": \"replacement\"}]. "
+                                   "The edits are applied in sequence, and each one can modify the result of previous edits. "
+                                   "AVOID multiple tool calls for the same file - instead, group all edits into a single call."
                 },
                 "options": {
                     "type": "object",
                     "properties": {
                         "partialMatch": {
                             "type": "boolean",
-                            "description": "Enable fuzzy matching for finding text. When true, the tool will try to find the best match even if it's not an exact match, using a confidence threshold of 80%.",
+                            "description": "Enable fuzzy matching for finding text. When true, the tool will try to find the best match even if it's not an exact match, using the confidenceThreshold (default 80%).",
                             "default": True
+                        },
+                        "confidenceThreshold": {
+                            "type": "number",
+                            "description": "Minimum confidence threshold for fuzzy matching (0.0 to 1.0). Higher values require more exact matches. Default is 0.8 (80% confidence).",
+                            "minimum": 0.0,
+                            "maximum": 1.0,
+                            "default": 0.8
                         }
                     }
                 }
@@ -784,11 +794,17 @@ def find_best_match(content: str, pattern: str, partial_match: bool = True) -> t
 
     return best_start, best_end, best_score
 
-async def apply_file_edits(file_path: str, edits: List[dict], dry_run: bool = False, options: dict = None) -> str:
-    """Apply edits to a file with optional formatting and return diff."""
+async def apply_file_edits(file_path: str, edits: List[dict], options: dict = None) -> tuple[str, bool, int, int]:
+    """Apply edits to a file with optional formatting and return diff.
+    
+    Returns:
+        tuple: (result_text, has_changes, successful_edits, failed_edits)
+    """
     # Set default options
     options = options or {}
     partial_match = options.get('partialMatch', True)
+    # Use 0.8 confidence threshold to prevent false positives while allowing reasonable fuzzy matches
+    confidence_threshold = options.get('confidenceThreshold', 0.8)
 
     # Read file content
     with open(file_path, 'r', encoding='utf-8') as f:
@@ -797,9 +813,10 @@ async def apply_file_edits(file_path: str, edits: List[dict], dry_run: bool = Fa
     # Track modifications
     modified_content = content
     failed_matches = []
+    successful_edits = []
 
     # Apply each edit
-    for edit in edits:
+    for edit_idx, edit in enumerate(edits):
         old_text = edit['oldText']
         new_text = edit['newText']
 
@@ -810,7 +827,7 @@ async def apply_file_edits(file_path: str, edits: List[dict], dry_run: bool = Fa
         # Find best match
         start, end, confidence = find_best_match(working_content, search_text, partial_match)
 
-        if confidence >= 0.8:
+        if confidence >= confidence_threshold:
             # Fix indentation while preserving relative structure
             if start >= 0:
                 # Get the indentation of the first line of the matched text
@@ -851,31 +868,77 @@ async def apply_file_edits(file_path: str, edits: List[dict], dry_run: bool = Fa
 
             # Apply the edit
             modified_content = modified_content[:start] + replacement + modified_content[end:]
+            successful_edits.append({
+                'index': edit_idx,
+                'oldText': old_text,
+                'newText': new_text,
+                'confidence': confidence
+            })
         else:
             failed_matches.append({
+                'index': edit_idx,
                 'oldText': old_text,
+                'newText': new_text,
                 'confidence': confidence,
                 'bestMatch': working_content[start:end] if start >= 0 and end > start else None
             })
 
     # Create diff
     diff = create_unified_diff(content, modified_content, os.path.basename(file_path))
+    has_changes = modified_content != content
 
-    # Write changes if not dry run
-    if not dry_run and not failed_matches:
+    # CRITICAL FIX: Write changes even if some edits failed (partial success)
+    # This prevents the infinite retry loop
+    if has_changes:
         with open(file_path, 'w', encoding='utf-8') as f:
             f.write(modified_content)
 
-    # Return results
-    failed_matches_text = '=== Failed Matches ===\n' + json.dumps(failed_matches, indent=2) + '\n\n' if failed_matches else ''
-    diff_text = f'=== Diff ===\n{diff}'
-    return failed_matches_text + diff_text
+    # Build comprehensive result message
+    result_parts = []
+    
+    # Summary
+    total_edits = len(edits)
+    successful_count = len(successful_edits)
+    failed_count = len(failed_matches)
+    
+    result_parts.append(f'=== Edit Summary ===')
+    result_parts.append(f'Total edits: {total_edits}')
+    result_parts.append(f'Successful: {successful_count}')
+    result_parts.append(f'Failed: {failed_count}')
+    result_parts.append(f'File modified: {has_changes}')
+    result_parts.append('')
+    
+    # Failed matches details
+    if failed_matches:
+        result_parts.append('=== Failed Matches ===')
+        for failed in failed_matches:
+            result_parts.append(f"Edit #{failed['index'] + 1}: Confidence {failed['confidence']:.2f}")
+            result_parts.append(f"  Searched for: {repr(failed['oldText'][:100])}...")
+            if failed['bestMatch']:
+                result_parts.append(f"  Best match: {repr(failed['bestMatch'][:100])}...")
+            result_parts.append('')
+    
+    # Successful edits
+    if successful_edits:
+        result_parts.append('=== Successful Edits ===')
+        for success in successful_edits:
+            result_parts.append(f"Edit #{success['index'] + 1}: Confidence {success['confidence']:.2f}")
+        result_parts.append('')
+    
+    # Diff
+    if diff.strip():
+        result_parts.append('=== Diff ===')
+        result_parts.append(diff)
+    else:
+        result_parts.append('=== No Changes ===')
+        result_parts.append('No modifications were made to the file.')
+    
+    return '\n'.join(result_parts), has_changes, successful_count, failed_count
 
 async def handle_edit_file(arguments: dict):
     """Handle editing a file with pattern matching and formatting."""
     path = arguments.get("path")
     edits = arguments.get("edits")
-    dry_run = arguments.get("dryRun", False)
     options = arguments.get("options", {})
 
     if not path:
@@ -900,8 +963,14 @@ async def handle_edit_file(arguments: dict):
         raise ValueError(f"Access denied: Path ({full_path}) must be within allowed directory ({state.allowed_directory})")
 
     try:
-        result = await apply_file_edits(full_path, edits, dry_run, options)
-        return [TextContent(type="text", text=result)]
+        result_text, has_changes, successful_count, failed_count = await apply_file_edits(full_path, edits, options)
+        
+        # CRITICAL FIX: Raise an exception only if ALL edits failed AND no changes were made
+        # This prevents silent failures that cause infinite retry loops
+        if failed_count > 0 and successful_count == 0:
+            raise ValueError(f"All {failed_count} edits failed to match. No changes were made to the file. Check the 'oldText' patterns and ensure they match the file content exactly.")
+        
+        return [TextContent(type="text", text=result_text)]
     except Exception as e:
         raise ValueError(f"Error editing file: {str(e)}")