wcgw 2.0.2__tar.gz → 2.0.4__tar.gz

{wcgw-2.0.2 → wcgw-2.0.4}/PKG-INFO

@@ -1,7 +1,7 @@
 Metadata-Version: 2.3
 Name: wcgw
-Version: 2.0.2
-Summary: What could go wrong giving full shell access to chatgpt?
+Version: 2.0.4
+Summary: Shell and coding agent on claude and chatgpt
 Project-URL: Homepage, https://github.com/rusiaaman/wcgw
 Author-email: Aman Rusia <gapypi@arcfu.com>
 Requires-Python: <3.13,>=3.11
@@ -29,8 +29,8 @@ Description-Content-Type: text/markdown
 
 # Shell and Coding agent for Claude and Chatgpt
 
-- Claude - An MCP server on claude desktop for autonomous shell, coding and desktop control agent.
-- Chatgpt - Allows custom gpt to talk to your shell via a relay server. 
+- Claude - An MCP server on claude desktop for autonomous shell, coding and desktop control agent. (mac only)
+- Chatgpt - Allows custom gpt to talk to your shell via a relay server. (linux or mac)
 
 [![Tests](https://github.com/rusiaaman/wcgw/actions/workflows/python-tests.yml/badge.svg?branch=main)](https://github.com/rusiaaman/wcgw/actions/workflows/python-tests.yml)
 [![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)
@@ -47,12 +47,29 @@ Description-Content-Type: text/markdown
 - ⚡ **Full Shell Access**: No restrictions, complete control.
 - ⚡ **Desktop control on Claude**: Screen capture, mouse control, keyboard control on claude desktop (on mac with docker linux)
 - ⚡ **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.
+- ⚡ **Large file edit**: Supports large file incremental edits to avoid token limit issues. Faster than full file write.
 - ⚡ **Interactive Command Handling**: Supports interactive commands using arrow keys, interrupt, and ansi escape sequences.
 - ⚡ **REPL support**: [beta] Supports python/node and other REPL execution.
 
+## Top use cases examples
+- Solve problem X using python, create and run test cases and fix any issues. Do it in a temporary directory
+- Find instances of code with X behavior in my repository
+- Git clone https://github.com/my/repo in my home directory, then understand the project, set up the environment and build
+- Create a golang htmx tailwind webapp, then open browser to see if it works (use with puppeteer mcp)
+- Edit or update a large file
+- In a separate branch create feature Y, then use github cli to create a PR to original branch
+- Command X is failing in Y directory, please run and fix issues
+- Using X virtual environment run Y command
+- Using cli tools, create build and test an android app. Finally run it using emulator for me to use
+- Fix all mypy issues in my repo at X path.
+- Using 'screen' run my server in background instead, then run another api server in bg, finally run the frontend build. Keep checking logs for any issues in all three
+- Create repo wide unittest cases. Keep iterating through files and creating cases. Also keep running the tests after each update. Do not modify original code.
+
 ## Claude Setup
 
-Update `claude_desktop_config.json` (~/Library/Application Support/Claude/claude_desktop_config.json)
+First install `uv` https://docs.astral.sh/uv/getting-started/installation/#installation-methods
+
+Then update `claude_desktop_config.json` (~/Library/Application Support/Claude/claude_desktop_config.json)
 
 ```json
 {

{wcgw-2.0.2 → wcgw-2.0.4}/README.md

@@ -1,7 +1,7 @@
 # Shell and Coding agent for Claude and Chatgpt
 
-- Claude - An MCP server on claude desktop for autonomous shell, coding and desktop control agent.
-- Chatgpt - Allows custom gpt to talk to your shell via a relay server. 
+- Claude - An MCP server on claude desktop for autonomous shell, coding and desktop control agent. (mac only)
+- Chatgpt - Allows custom gpt to talk to your shell via a relay server. (linux or mac)
 
 [![Tests](https://github.com/rusiaaman/wcgw/actions/workflows/python-tests.yml/badge.svg?branch=main)](https://github.com/rusiaaman/wcgw/actions/workflows/python-tests.yml)
 [![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)
@@ -18,12 +18,29 @@
 - ⚡ **Full Shell Access**: No restrictions, complete control.
 - ⚡ **Desktop control on Claude**: Screen capture, mouse control, keyboard control on claude desktop (on mac with docker linux)
 - ⚡ **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.
+- ⚡ **Large file edit**: Supports large file incremental edits to avoid token limit issues. Faster than full file write.
 - ⚡ **Interactive Command Handling**: Supports interactive commands using arrow keys, interrupt, and ansi escape sequences.
 - ⚡ **REPL support**: [beta] Supports python/node and other REPL execution.
 
+## Top use cases examples
+- Solve problem X using python, create and run test cases and fix any issues. Do it in a temporary directory
+- Find instances of code with X behavior in my repository
+- Git clone https://github.com/my/repo in my home directory, then understand the project, set up the environment and build
+- Create a golang htmx tailwind webapp, then open browser to see if it works (use with puppeteer mcp)
+- Edit or update a large file
+- In a separate branch create feature Y, then use github cli to create a PR to original branch
+- Command X is failing in Y directory, please run and fix issues
+- Using X virtual environment run Y command
+- Using cli tools, create build and test an android app. Finally run it using emulator for me to use
+- Fix all mypy issues in my repo at X path.
+- Using 'screen' run my server in background instead, then run another api server in bg, finally run the frontend build. Keep checking logs for any issues in all three
+- Create repo wide unittest cases. Keep iterating through files and creating cases. Also keep running the tests after each update. Do not modify original code.
+
 ## Claude Setup
 
-Update `claude_desktop_config.json` (~/Library/Application Support/Claude/claude_desktop_config.json)
+First install `uv` https://docs.astral.sh/uv/getting-started/installation/#installation-methods
+
+Then update `claude_desktop_config.json` (~/Library/Application Support/Claude/claude_desktop_config.json)
 
 ```json
 {

{wcgw-2.0.2 → wcgw-2.0.4}/openai.md

@@ -4,8 +4,8 @@
 
 1. Run a relay server with a domain name and https support (or use ngrok) use the instructions in next section.
 2. Create a custom gpt that connects to the relay server, instructions in next sections.
-3. Run the [cli client](https://github.com/rusiaaman/wcgw?tab=readme-ov-file#client) in any directory of choice.
-4. The custom GPT can now run any command on your cli
+3. Run the client in any directory of choice. `uvx wcgw@latest`
+4. The custom GPT can now run any command on your terminal
 
 ## Creating the relay server
 

{wcgw-2.0.2 → wcgw-2.0.4}/pyproject.toml

@@ -1,8 +1,8 @@
 [project]
 authors = [{ name = "Aman Rusia", email = "gapypi@arcfu.com" }]
 name = "wcgw"
-version = "2.0.2"
-description = "What could go wrong giving full shell access to chatgpt?"
+version = "2.0.4"
+description = "Shell and coding agent on claude and chatgpt"
 readme = "README.md"
 requires-python = ">=3.11, <3.13"
 dependencies = [

{wcgw-2.0.2 → wcgw-2.0.4}/src/wcgw/client/anthropic_client.py

@@ -262,6 +262,7 @@ def loop(
 - Interact with the linux os on docker using mouse.
 - Uses xdotool
 - About left_click_drag: the current mouse position will be used as the starting point, click and drag to the given x, y coordinates. Useful in things like sliders, moving things around, etc.
+- The output of this command has the screenshot after doing this action. Use this to verify if the action was successful.
 """,
             ),
             ToolParam(
@@ -272,6 +273,8 @@ def loop(
 - Emulate keyboard input to the screen
 - Uses xdootool to send keyboard input, keys like Return, BackSpace, Escape, Page_Up, etc. can be used.
 - Do not use it to interact with Bash tool.
+- Make sure you've selected a text area or an editable element before sending text.
+- The output of this command has the screenshot after doing this action. Use this to verify if the action was successful.
 """,
             ),
         ]

{wcgw-2.0.2 → wcgw-2.0.4}/src/wcgw/client/mcp_server/server.py

@@ -178,6 +178,7 @@ async def handle_list_tools() -> list[types.Tool]:
 - Interact with the linux os on docker using mouse.
 - Uses xdotool
 - About left_click_drag: the current mouse position will be used as the starting point, click and drag to the given x, y coordinates. Useful in things like sliders, moving things around, etc.
+- The output of this command has the screenshot after doing this action. Use this to verify if the action was successful.
 """,
             ),
             ToolParam(
@@ -189,6 +190,7 @@ async def handle_list_tools() -> list[types.Tool]:
 - Uses xdootool to send keyboard input, keys like Return, BackSpace, Escape, Page_Up, etc. can be used.
 - Do not use it to interact with Bash tool.
 - Make sure you've selected a text area or an editable element before sending text.
+- The output of this command has the screenshot after doing this action. Use this to verify if the action was successful.
 """,
             ),
         ]

{wcgw-2.0.2 → wcgw-2.0.4}/src/wcgw/client/tools.py

@@ -106,13 +106,27 @@ PROMPT = PROMPT_CONST
 
 
 def start_shell() -> pexpect.spawn:  # type: ignore
-    SHELL = pexpect.spawn(
-        "/bin/bash --noprofile --norc",
-        env={**os.environ, **{"PS1": PROMPT}},  # type: ignore[arg-type]
-        echo=False,
-        encoding="utf-8",
-        timeout=TIMEOUT,
-    )
+    try:
+        SHELL = pexpect.spawn(
+            "/bin/bash",
+            env={**os.environ, **{"PS1": PROMPT}},  # type: ignore[arg-type]
+            echo=False,
+            encoding="utf-8",
+            timeout=TIMEOUT,
+        )
+        SHELL.sendline(f"export PS1={PROMPT}")
+    except Exception as e:
+        traceback.print_exc()
+        console.log(f"Error starting shell: {e}. Retrying without rc ...")
+
+        SHELL = pexpect.spawn(
+            "/bin/bash --noprofile --norc",
+            env={**os.environ, **{"PS1": PROMPT}},  # type: ignore[arg-type]
+            echo=False,
+            encoding="utf-8",
+            timeout=TIMEOUT,
+        )
+
     SHELL.expect(PROMPT, timeout=TIMEOUT)
     SHELL.sendline("stty -icanon -echo")
     SHELL.expect(PROMPT, timeout=TIMEOUT)

{wcgw-2.0.2 → wcgw-2.0.4}/uv.lock

@@ -860,7 +860,7 @@ wheels = [
 
 [[package]]
 name = "wcgw"
-version = "2.0.2"
+version = "2.0.4"
 source = { editable = "." }
 dependencies = [
     { name = "anthropic" },