wcgw 3.0.7__tar.gz → 4.0.0__tar.gz

{wcgw-3.0.7 → wcgw-4.0.0}/.github/workflows/python-tests.yml

@@ -28,8 +28,7 @@ jobs:
           uv venv --python "${{ matrix.python-version }}"
       - name: Run tests with coverage
         run: |
-          uv pip install pytest pytest-cov
-          uv run pytest --cov=wcgw --cov-report=xml --cov-report=term-missing
+          uv run --python "${{ matrix.python-version }}" pytest --cov=wcgw --cov-report=xml --cov-report=term-missing
       - name: Upload coverage reports to Codecov
         uses: codecov/codecov-action@v4
         if: success()

{wcgw-3.0.7 → wcgw-4.0.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wcgw
-Version: 3.0.7
+Version: 4.0.0
 Summary: Shell and coding agent on claude and chatgpt
 Project-URL: Homepage, https://github.com/rusiaaman/wcgw
 Author-email: Aman Rusia <gapypi@arcfu.com>
@@ -17,7 +17,6 @@ Requires-Dist: pyte>=0.8.2
 Requires-Dist: python-dotenv>=1.0.1
 Requires-Dist: rich>=13.8.1
 Requires-Dist: semantic-version>=2.10.0
-Requires-Dist: shell>=1.0.1
 Requires-Dist: syntax-checker>=0.3.0
 Requires-Dist: tokenizers>=0.21.0
 Requires-Dist: toml>=0.10.2
@@ -30,8 +29,8 @@ Description-Content-Type: text/markdown
 
 Empowering chat applications to code, build and run on your local machine.
 
-- Claude - An MCP server on claude desktop for autonomous shell and coding agent. (mac only)
-- Chatgpt - Allows custom gpt to talk to your shell via a relay server. (linux or mac)
+- Claude - An MCP server on claude desktop for autonomous shell and coding agent. (mac, linux, windows on wsl)
+- Chatgpt - Allows custom gpt to talk to your shell via a relay server. (linux, mac, windows on wsl)
 
 ⚠️ Warning: do not allow BashCommand tool without reviewing the command, it may result in data loss.
 
@@ -39,7 +38,11 @@ Empowering chat applications to code, build and run on your local machine.
 [![Mypy strict](https://github.com/rusiaaman/wcgw/actions/workflows/python-types.yml/badge.svg?branch=main)](https://github.com/rusiaaman/wcgw/actions/workflows/python-types.yml)
 [![Build](https://github.com/rusiaaman/wcgw/actions/workflows/python-publish.yml/badge.svg)](https://github.com/rusiaaman/wcgw/actions/workflows/python-publish.yml)
 [![codecov](https://codecov.io/gh/rusiaaman/wcgw/graph/badge.svg)](https://codecov.io/gh/rusiaaman/wcgw)
-[![smithery badge](https://smithery.ai/badge/wcgw)](https://smithery.ai/server/wcgw)
+[![Reddit](https://img.shields.io/badge/Reddit-r%2Fwcgw_mcp-red)](https://www.reddit.com/r/wcgw_mcp/)
+
+## Demo
+
+![Workflow Demo](static/workflow-demo.gif)
 
 ## Updates
 
@@ -53,7 +56,6 @@ Empowering chat applications to code, build and run on your local machine.
 
 - [9 Dec 2024] [Vscode extension to paste context on Claude app](https://marketplace.visualstudio.com/items?itemName=AmanRusia.wcgw)
 
-
 ## 🚀 Highlights
 
 - ⚡ **Create, Execute, Iterate**: Ask claude to keep running compiler checks till all errors are fixed, or ask it to keep checking for the status of a long running command till it's done.
@@ -96,6 +98,8 @@ Empowering chat applications to code, build and run on your local machine.
 
 ## Claude setup (using mcp)
 
+### Mac and linux
+
 First install `uv` using homebrew `brew install uv`
 
 (**Important:** use homebrew to install uv. Otherwise make sure `uv` is present in a global location like /usr/bin/)
@@ -131,18 +135,33 @@ _If there's an error in setting up_
 - Try using `uv` version `0.6.0` for which this tool was tested.
 - Debug the mcp server using `npx @modelcontextprotocol/inspector@0.1.7 uv tool run --from wcgw@latest --python 3.12 wcgw_mcp`
 
-### Alternative configuration using smithery (npx required)
+### Windows on wsl
 
-You need to first install uv using homebrew. `brew install uv`
+This mcp server works only on wsl on windows.
 
-Then to configure wcgw for Claude Desktop automatically via [Smithery](https://smithery.ai/server/wcgw):
+To set it up, [install uv](https://docs.astral.sh/uv/getting-started/installation/)
 
-```bash
-npx -y @smithery/cli install wcgw --client claude
-```
+Then add or update the claude config file `%APPDATA%\Claude\claude_desktop_config.json` with the following
 
-_If there's an error in setting up_
-- Try removing ~/.cache/uv folder
+```json
+{
+  "mcpServers": {
+    "wcgw": {
+      "command": "wsl.exe",
+      "args": [
+        "uv",
+        "tool",
+        "run",
+        "--from",
+        "wcgw@latest",
+        "--python",
+        "3.12",
+        "wcgw_mcp"
+      ]
+    }
+  }
+}
+```
 
 ### Usage
 
@@ -174,6 +193,7 @@ There are three built-in modes. You may ask Claude to run in one of the modes, l
 Note: in code-writer mode either all commands are allowed or none are allowed for now. If you give a list of allowed commands, Claude is instructed to run only those commands, but no actual check happens. (WIP)
 
 #### Attach to the working terminal to investigate
+
 If you've `screen` command installed, wcgw runs on a screen instance automatically. If you've started wcgw mcp server, you can list the screen sessions:
 
 `screen -ls`
@@ -184,7 +204,7 @@ You can then attach to the session using `screen -x 93358.wcgw.235521`
 
 You may interrupt any running command safely.
 
-You can interact with the terminal but beware that the AI might be running in parallel and it may conflict with what you're doing. It's recommended to keep your interactions to minimum. 
+You can interact with the terminal but beware that the AI might be running in parallel and it may conflict with what you're doing. It's recommended to keep your interactions to minimum.
 
 You shouldn't exit the session using `exit `or Ctrl-d, instead you should use `ctrl+a+d` to safely detach without destroying the screen session.
 
@@ -204,12 +224,12 @@ Read here: https://github.com/rusiaaman/wcgw/blob/main/openai.md
 
 ![example](https://github.com/rusiaaman/wcgw/blob/main/static/example.jpg?raw=true)
 
-
 ## Using mcp server over docker
 
 First build the docker image `docker build -t wcgw https://github.com/rusiaaman/wcgw.git`
 
 Then you can update `/Users/username/Library/Application Support/Claude/claude_desktop_config.json` to have
+
 ```
 {
   "mcpServers": {
@@ -228,8 +248,6 @@ Then you can update `/Users/username/Library/Application Support/Claude/claude_d
 }
 ```
 
-
-
 ## [Optional] Local shell access with openai API key or anthropic API key
 
 ### Openai
@@ -281,4 +299,3 @@ The server provides the following MCP tools:
   - Parameters: `id` (string), `project_root_path` (string), `description` (string), `relevant_file_globs` (string[])
 
 All tools support absolute paths and include built-in protections against common errors. See the [MCP specification](https://modelcontextprotocol.io/) for detailed protocol information.
-

{wcgw-3.0.7 → wcgw-4.0.0}/README.md

@@ -2,8 +2,8 @@
 
 Empowering chat applications to code, build and run on your local machine.
 
-- Claude - An MCP server on claude desktop for autonomous shell and coding agent. (mac only)
-- Chatgpt - Allows custom gpt to talk to your shell via a relay server. (linux or mac)
+- Claude - An MCP server on claude desktop for autonomous shell and coding agent. (mac, linux, windows on wsl)
+- Chatgpt - Allows custom gpt to talk to your shell via a relay server. (linux, mac, windows on wsl)
 
 ⚠️ Warning: do not allow BashCommand tool without reviewing the command, it may result in data loss.
 
@@ -11,7 +11,11 @@ Empowering chat applications to code, build and run on your local machine.
 [![Mypy strict](https://github.com/rusiaaman/wcgw/actions/workflows/python-types.yml/badge.svg?branch=main)](https://github.com/rusiaaman/wcgw/actions/workflows/python-types.yml)
 [![Build](https://github.com/rusiaaman/wcgw/actions/workflows/python-publish.yml/badge.svg)](https://github.com/rusiaaman/wcgw/actions/workflows/python-publish.yml)
 [![codecov](https://codecov.io/gh/rusiaaman/wcgw/graph/badge.svg)](https://codecov.io/gh/rusiaaman/wcgw)
-[![smithery badge](https://smithery.ai/badge/wcgw)](https://smithery.ai/server/wcgw)
+[![Reddit](https://img.shields.io/badge/Reddit-r%2Fwcgw_mcp-red)](https://www.reddit.com/r/wcgw_mcp/)
+
+## Demo
+
+![Workflow Demo](static/workflow-demo.gif)
 
 ## Updates
 
@@ -25,7 +29,6 @@ Empowering chat applications to code, build and run on your local machine.
 
 - [9 Dec 2024] [Vscode extension to paste context on Claude app](https://marketplace.visualstudio.com/items?itemName=AmanRusia.wcgw)
 
-
 ## 🚀 Highlights
 
 - ⚡ **Create, Execute, Iterate**: Ask claude to keep running compiler checks till all errors are fixed, or ask it to keep checking for the status of a long running command till it's done.
@@ -68,6 +71,8 @@ Empowering chat applications to code, build and run on your local machine.
 
 ## Claude setup (using mcp)
 
+### Mac and linux
+
 First install `uv` using homebrew `brew install uv`
 
 (**Important:** use homebrew to install uv. Otherwise make sure `uv` is present in a global location like /usr/bin/)
@@ -103,18 +108,33 @@ _If there's an error in setting up_
 - Try using `uv` version `0.6.0` for which this tool was tested.
 - Debug the mcp server using `npx @modelcontextprotocol/inspector@0.1.7 uv tool run --from wcgw@latest --python 3.12 wcgw_mcp`
 
-### Alternative configuration using smithery (npx required)
+### Windows on wsl
 
-You need to first install uv using homebrew. `brew install uv`
+This mcp server works only on wsl on windows.
 
-Then to configure wcgw for Claude Desktop automatically via [Smithery](https://smithery.ai/server/wcgw):
+To set it up, [install uv](https://docs.astral.sh/uv/getting-started/installation/)
 
-```bash
-npx -y @smithery/cli install wcgw --client claude
-```
+Then add or update the claude config file `%APPDATA%\Claude\claude_desktop_config.json` with the following
 
-_If there's an error in setting up_
-- Try removing ~/.cache/uv folder
+```json
+{
+  "mcpServers": {
+    "wcgw": {
+      "command": "wsl.exe",
+      "args": [
+        "uv",
+        "tool",
+        "run",
+        "--from",
+        "wcgw@latest",
+        "--python",
+        "3.12",
+        "wcgw_mcp"
+      ]
+    }
+  }
+}
+```
 
 ### Usage
 
@@ -146,6 +166,7 @@ There are three built-in modes. You may ask Claude to run in one of the modes, l
 Note: in code-writer mode either all commands are allowed or none are allowed for now. If you give a list of allowed commands, Claude is instructed to run only those commands, but no actual check happens. (WIP)
 
 #### Attach to the working terminal to investigate
+
 If you've `screen` command installed, wcgw runs on a screen instance automatically. If you've started wcgw mcp server, you can list the screen sessions:
 
 `screen -ls`
@@ -156,7 +177,7 @@ You can then attach to the session using `screen -x 93358.wcgw.235521`
 
 You may interrupt any running command safely.
 
-You can interact with the terminal but beware that the AI might be running in parallel and it may conflict with what you're doing. It's recommended to keep your interactions to minimum. 
+You can interact with the terminal but beware that the AI might be running in parallel and it may conflict with what you're doing. It's recommended to keep your interactions to minimum.
 
 You shouldn't exit the session using `exit `or Ctrl-d, instead you should use `ctrl+a+d` to safely detach without destroying the screen session.
 
@@ -176,12 +197,12 @@ Read here: https://github.com/rusiaaman/wcgw/blob/main/openai.md
 
 ![example](https://github.com/rusiaaman/wcgw/blob/main/static/example.jpg?raw=true)
 
-
 ## Using mcp server over docker
 
 First build the docker image `docker build -t wcgw https://github.com/rusiaaman/wcgw.git`
 
 Then you can update `/Users/username/Library/Application Support/Claude/claude_desktop_config.json` to have
+
 ```
 {
   "mcpServers": {
@@ -200,8 +221,6 @@ Then you can update `/Users/username/Library/Application Support/Claude/claude_d
 }
 ```
 
-
-
 ## [Optional] Local shell access with openai API key or anthropic API key
 
 ### Openai
@@ -253,4 +272,3 @@ The server provides the following MCP tools:
   - Parameters: `id` (string), `project_root_path` (string), `description` (string), `relevant_file_globs` (string[])
 
 All tools support absolute paths and include built-in protections against common errors. See the [MCP specification](https://modelcontextprotocol.io/) for detailed protocol information.
-

{wcgw-3.0.7 → wcgw-4.0.0}/gpt_action_json_schema.json

@@ -10,16 +10,16 @@
     }
   ],
   "paths": {
-    "/v1/create_file": {
+    "/v1/file_write_or_edit": {
       "post": {
         "x-openai-isConsequential": false,
-        "summary": "Create File",
-        "operationId": "create_file_v1_create_file_post",
+        "summary": "File Write Or Edit",
+        "operationId": "file_write_or_edit_v1_file_write_or_edit_post",
         "requestBody": {
           "content": {
             "application/json": {
               "schema": {
-                "$ref": "#/components/schemas/WriteIfEmptyWithUUID"
+                "$ref": "#/components/schemas/FileWriteOrEdithUUID"
               }
             }
           },
@@ -32,47 +32,7 @@
               "application/json": {
                 "schema": {
                   "type": "string",
-                  "title": "Response Create File V1 Create File Post"
-                }
-              }
-            }
-          },
-          "422": {
-            "description": "Validation Error",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/HTTPValidationError"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
-    "/v1/full_file_edit": {
-      "post": {
-        "x-openai-isConsequential": false,
-        "summary": "File Edit Find Replace",
-        "operationId": "file_edit_find_replace_v1_full_file_edit_post",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/FileEditWithUUID"
-              }
-            }
-          },
-          "required": true
-        },
-        "responses": {
-          "200": {
-            "description": "Successful Response",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "string",
-                  "title": "Response File Edit Find Replace V1 Full File Edit Post"
+                  "title": "Response File Write Or Edit V1 File Write Or Edit Post"
                 }
               }
             }
@@ -288,10 +248,7 @@
         },
         "additionalProperties": false,
         "type": "object",
-        "required": [
-          "allowed_globs",
-          "allowed_commands"
-        ],
+        "required": ["allowed_globs", "allowed_commands"],
         "title": "CodeWriterMode"
       },
       "Command": {
@@ -303,9 +260,7 @@
         },
         "additionalProperties": false,
         "type": "object",
-        "required": [
-          "command"
-        ],
+        "required": ["command"],
         "title": "Command"
       },
       "CommandWithUUID": {
@@ -328,7 +283,7 @@
                 "$ref": "#/components/schemas/SendAscii"
               }
             ],
-            "title": "ActionJson"
+            "title": "Action Json"
           },
           "wait_for_seconds": {
             "anyOf": [
@@ -349,10 +304,7 @@
         },
         "additionalProperties": false,
         "type": "object",
-        "required": [
-          "action_json",
-          "user_id"
-        ],
+        "required": ["action_json", "user_id"],
         "title": "CommandWithUUID"
       },
       "ContextSaveWithUUID": {
@@ -393,15 +345,19 @@
         ],
         "title": "ContextSaveWithUUID"
       },
-      "FileEditWithUUID": {
+      "FileWriteOrEdithUUID": {
         "properties": {
           "file_path": {
             "type": "string",
             "title": "File Path"
           },
-          "file_edit_using_search_replace_blocks": {
+          "percentage_to_change": {
+            "type": "integer",
+            "title": "Percentage To Change"
+          },
+          "file_content_or_search_replace_blocks": {
             "type": "string",
-            "title": "File Edit Using Search Replace Blocks"
+            "title": "File Content Or Search Replace Blocks"
           },
           "user_id": {
             "type": "string",
@@ -413,10 +369,11 @@
         "type": "object",
         "required": [
           "file_path",
-          "file_edit_using_search_replace_blocks",
+          "percentage_to_change",
+          "file_content_or_search_replace_blocks",
           "user_id"
         ],
-        "title": "FileEditWithUUID"
+        "title": "FileWriteOrEdithUUID"
       },
       "HTTPValidationError": {
         "properties": {
@@ -460,11 +417,7 @@
           },
           "mode_name": {
             "type": "string",
-            "enum": [
-              "wcgw",
-              "architect",
-              "code_writer"
-            ],
+            "enum": ["wcgw", "architect", "code_writer"],
             "title": "Mode Name"
           },
           "code_writer_config": {
@@ -504,6 +457,17 @@
             "type": "array",
             "title": "File Paths"
           },
+          "show_line_numbers_reason": {
+            "anyOf": [
+              {
+                "type": "string"
+              },
+              {
+                "type": "null"
+              }
+            ],
+            "title": "Show Line Numbers Reason"
+          },
           "user_id": {
             "type": "string",
             "format": "uuid",
@@ -512,10 +476,7 @@
         },
         "additionalProperties": false,
         "type": "object",
-        "required": [
-          "file_paths",
-          "user_id"
-        ],
+        "required": ["file_paths", "user_id"],
         "title": "ReadFileWithUUID"
       },
       "SendAscii": {
@@ -530,9 +491,7 @@
         },
         "additionalProperties": false,
         "type": "object",
-        "required": [
-          "send_ascii"
-        ],
+        "required": ["send_ascii"],
         "title": "SendAscii"
       },
       "SendSpecials": {
@@ -547,8 +506,7 @@
                 "Key-left",
                 "Key-right",
                 "Ctrl-c",
-                "Ctrl-d",
-                "Ctrl-z"
+                "Ctrl-d"
               ]
             },
             "type": "array",
@@ -557,9 +515,7 @@
         },
         "additionalProperties": false,
         "type": "object",
-        "required": [
-          "send_specials"
-        ],
+        "required": ["send_specials"],
         "title": "SendSpecials"
       },
       "SendText": {
@@ -571,9 +527,7 @@
         },
         "additionalProperties": false,
         "type": "object",
-        "required": [
-          "send_text"
-        ],
+        "required": ["send_text"],
         "title": "SendText"
       },
       "StatusCheck": {
@@ -586,9 +540,7 @@
         },
         "additionalProperties": false,
         "type": "object",
-        "required": [
-          "status_check"
-        ],
+        "required": ["status_check"],
         "title": "StatusCheck"
       },
       "ValidationError": {
@@ -617,38 +569,9 @@
           }
         },
         "type": "object",
-        "required": [
-          "loc",
-          "msg",
-          "type"
-        ],
+        "required": ["loc", "msg", "type"],
         "title": "ValidationError"
-      },
-      "WriteIfEmptyWithUUID": {
-        "properties": {
-          "file_path": {
-            "type": "string",
-            "title": "File Path"
-          },
-          "file_content": {
-            "type": "string",
-            "title": "File Content"
-          },
-          "user_id": {
-            "type": "string",
-            "format": "uuid",
-            "title": "User Id"
-          }
-        },
-        "additionalProperties": false,
-        "type": "object",
-        "required": [
-          "file_path",
-          "file_content",
-          "user_id"
-        ],
-        "title": "WriteIfEmptyWithUUID"
       }
     }
   }
-}
+}

{wcgw-3.0.7 → wcgw-4.0.0}/gpt_instructions.txt

@@ -33,23 +33,24 @@ Instructions for `BashCommand`:
 
 Instructions for `Read Files`
 - Read full file content of one or more files.
-- Provide absolute file paths only
-
-Instructions for `Write if Empty`
-- Write content to an empty or non-existent file. Provide file path and content. Use this instead of BashCommand for writing new files.
-- Provide absolute file path only.
-- For editing existing files, use FileEdit.
+- Provide absolute paths only (~ allowed)
+- Only if the task requires line numbers understanding:
+    - You may populate "show_line_numbers_reason" with your reason, by default null/empty means no line numbers are shown.
+    - You may extract a range of lines. E.g., `/path/to/file:1-10` for lines 1-10. You can drop start or end like `/path/to/file:1-` or `/path/to/file:-10` 
+
+Instructions for `FileWriteOrEdit`
+- Writes or edits a file based on the percentage of changes.
+- Use absolute path only (~ allowed).
+- First write down percentage of lines that need to be replaced in the file (between 0-100) in percentage_to_change
+- percentage_to_change should be low if mostly new code is to be added. It should be high if a lot of things are to be replaced.
+- If percentage_to_change > 50, provide full file content in file_content_or_search_replace_blocks
+- If percentage_to_change <= 50, file_content_or_search_replace_blocks should be search/replace blocks.
 
 Instructions for `ContextSave`
 - Saves provided description and file contents of all the relevant file paths or globs in a single text file.
   - Provide random unqiue id or whatever user provided.
   - Leave project path as empty string if no project path
 
-Instructions for `FileEdit`:
-    - Use absolute file path only.
-    - Use SEARCH/REPLACE blocks to edit the file.
-        Only edit the files using the following SEARCH/REPLACE blocks.
-
 ```
 <<<<<<< SEARCH
 def hello():

{wcgw-3.0.7 → wcgw-4.0.0}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 authors = [{ name = "Aman Rusia", email = "gapypi@arcfu.com" }]
 name = "wcgw"
-version = "3.0.7"
+version = "4.0.0"
 description = "Shell and coding agent on claude and chatgpt"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -11,7 +11,6 @@ dependencies = [
     "rich>=13.8.1",
     "python-dotenv>=1.0.1",
     "pexpect>=4.9.0",
-    "shell>=1.0.1",
     "toml>=0.10.2",
     "petname>=2.6",
     "pyte>=0.8.2",