refactor: update tool names for consistency and clarity across documentation and examples

Author: yaonyan

README.md

@@ -74,9 +74,9 @@ Your capabilities include:
 - Interacting with GitHub to create pull requests and manage issues
 
 To perform these actions, you must use the following tools:
-- To execute a shell command: <tool name="desktop-commander.exec" />
-- To read a file's content: <tool name="desktop-commander.readFile" />
-- To write content to a file: <tool name="desktop-commander.writeFile" />
+- To execute a shell command: <tool name="desktop-commander.execute_command" />
+- To read a file's content: <tool name="desktop-commander.read_file" />
+- To write content to a file: <tool name="desktop-commander.write_file" />
 - To find symbol definitions: <tool name="lsmcp.definition" />
 - To create a GitHub pull request: <tool name="github.createPullRequest" />
 `;

docs/examples/creating-a-codex-fork.md

@@ -45,18 +45,25 @@ const deps: ComposeDefinition["deps"] = {
 const description = `
   You are a "codex fork" agent, a world-class AI assistant for coding tasks.
 
-  Your capabilities include:
-  - Reading and writing files.
-  - Searching the codebase using advanced language server features.
-  - Executing terminal commands to build, test, and run projects.
-  - Interacting with GitHub to create pull requests and manage issues.
+  Workflow:
+  1. Project Overview: Use <tool name="lsmcp.get_project_overview"/> to understand the project structure.
+  2. Code Discovery: Locate relevant files using <tool name="lsmcp.search_symbols"/>, <tool name="desktop-commander.search_code"/>, or <tool name="desktop-commander.list_directory"/>.
+  3. Implementation: Apply changes with <tool name="desktop-commander.edit_block"/> and verify with <tool name="lsmcp.lsp_get_diagnostics"/>.
+  4. Build and Commit: Execute build commands with <tool name="desktop-commander.execute_command"/>, then commit changes.
+  5. Submission: Create pull requests with <tool name="github.createPullRequest"/>.
 
-  To perform these actions, you must use the following tools:
-  - To execute a shell command: <tool name="desktop-commander.exec" />
-  - To read a file's content: <tool name="desktop-commander.readFile" />
-  - To write content to a file: <tool name="desktop-commander.writeFile" />
-  - To find symbol definitions: <tool name="lsmcp.definition" />
-  - To create a GitHub pull request: <tool name="github.createPullRequest" />
+  Available tools:
+  <tool name="desktop-commander.execute_command"/>
+  <tool name="desktop-commander.read_file"/>
+  <tool name="desktop-commander.write_file"/>
+  <tool name="desktop-commander.edit_block"/>
+  <tool name="desktop-commander.search_code"/>
+  <tool name="desktop-commander.list_directory"/>
+  <tool name="lsmcp.get_project_overview"/>
+  <tool name="lsmcp.search_symbols"/>
+  <tool name="lsmcp.definition"/>
+  <tool name="lsmcp.lsp_get_diagnostics"/>
+  <tool name="github.createPullRequest"/>
 `;
 
 // 3. Finally, Start the Agentic MCP Server

docs/faq.md

@@ -41,7 +41,7 @@ Code/compatible clients.
 Use `<tool name="server.toolname" />` syntax:
 
 ```xml
-<tool name="desktop-commander.exec" />
+<tool name="desktop-commander.execute_command" />
 <tool name="github.createPullRequest" />
 ```
 

packages/cli/examples/05-url-config.sh

@@ -12,7 +12,7 @@ echo ""
 GITHUB_USER="mcpc-tech"
 REPO_NAME="mcpc"
 BRANCH="main"
-CONFIG_PATH="packages/cli/examples/configs/simple.json"
+CONFIG_PATH="packages/cli/examples/configs/codex-fork.json"
 
 export MCPC_CONFIG_URL="https://raw.githubusercontent.com/${GITHUB_USER}/${REPO_NAME}/${BRANCH}/${CONFIG_PATH}"
 

packages/cli/examples/configs/README.md

@@ -4,16 +4,6 @@ This directory contains example configuration files for MCPC CLI.
 
 ## Available Configs
 
-### simple.json
-
-A minimal configuration for testing basic functionality.
-
-```bash
-# Use with MCPC_CONFIG_FILE
-export MCPC_CONFIG_FILE=examples/configs/simple.json
-deno run --allow-all src/bin.ts
-```
-
 ### codex-fork.json
 
 A full-featured "Codex Fork" agent based on the MCPC documentation example.
@@ -41,7 +31,7 @@ After pushing to GitHub, these configs can be loaded via URL:
 
 ```bash
 # Load simple config from GitHub
-export MCPC_CONFIG_URL="https://raw.githubusercontent.com/mcpc-tech/mcpc/main/packages/cli/examples/configs/simple.json"
+export MCPC_CONFIG_URL="https://raw.githubusercontent.com/mcpc-tech/mcpc/main/packages/cli/examples/configs/codex-fork.json"
 deno run --allow-all src/bin.ts
 
 # Or use the example script

packages/cli/examples/configs/codex-fork.json

@@ -8,7 +8,7 @@
   "agents": [
     {
       "name": "codex-fork-agent",
-      "description": "You are a \"codex fork\" agent, a world-class AI assistant for coding tasks.\n\nYour capabilities include:\n- Reading and writing files.\n- Searching the codebase using advanced language server features.\n- Executing terminal commands to build, test, and run projects.\n- Interacting with GitHub to create pull requests and manage issues.\n\nTo perform these actions, you must use the following tools:\n- To execute a shell command: <tool name=\"desktop-commander.exec\" />\n- To read a file's content: <tool name=\"desktop-commander.readFile\" />\n- To write content to a file: <tool name=\"desktop-commander.writeFile\" />\n- To find symbol definitions: <tool name=\"lsmcp.definition\" />\n- To create a GitHub pull request: <tool name=\"github.createPullRequest\" />",
+      "description": "You are a \"codex fork\" agent, a world-class AI assistant for coding tasks.\n\nWorkflow:\n1. Project Overview: Use <tool name=\"lsmcp.get_project_overview\"/> to understand the project structure.\n2. Code Discovery: Locate relevant files using <tool name=\"lsmcp.search_symbols\"/>, <tool name=\"desktop-commander.search_code\"/>, or <tool name=\"desktop-commander.list_directory\"/>.\n3. Implementation: Apply changes with <tool name=\"desktop-commander.edit_block\"/> and verify with <tool name=\"lsmcp.lsp_get_diagnostics\"/>.\n4. Build and Commit: Execute build commands with <tool name=\"desktop-commander.execute_command\"/>, then commit changes.\n5. Submission: Create pull requests with <tool name=\"github.createPullRequest\"/>.\n\nAvailable tools:\n<tool name=\"desktop-commander.execute_command\"/>\n<tool name=\"desktop-commander.read_file\"/>\n<tool name=\"desktop-commander.write_file\"/>\n<tool name=\"desktop-commander.edit_block\"/>\n<tool name=\"desktop-commander.search_code\"/>\n<tool name=\"desktop-commander.list_directory\"/>\n<tool name=\"lsmcp.get_project_overview\"/>\n<tool name=\"lsmcp.search_symbols\"/>\n<tool name=\"lsmcp.definition\"/>\n<tool name=\"lsmcp.lsp_get_diagnostics\"/>\n<tool name=\"github.createPullRequest\"/>",
       "options": {
         "mode": "agentic"
       },

packages/cli/examples/configs/simple.json

@@ -23,9 +23,9 @@
  * I am a coding assistant that can read files and run terminal commands.
  *
  * Available tools:
- * <tool name="desktop-commander.exec" />
- * <tool name="desktop-commander.readFile" />
- * <tool name="desktop-commander.writeFile" />
+ * <tool name="desktop-commander.execute_command" />
+ * <tool name="desktop-commander.read_file" />
+ * <tool name="desktop-commander.write_file" />
  * `
  *
  * // Create and start the server