wcgw 5.4.3__tar.gz → 5.4.4__tar.gz

{wcgw-5.4.3 → wcgw-5.4.4}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wcgw
-Version: 5.4.3
+Version: 5.4.4
 Summary: Shell and coding agent for Claude and other mcp clients
 Project-URL: Homepage, https://github.com/rusiaaman/wcgw
 Author-email: Aman Rusia <gapypi@arcfu.com>
@@ -86,7 +86,7 @@ wcgw is an MCP server with tightly integrated shell and code editing tools.
   - By default it runs in 'wcgw' mode that has no restrictions and full authorisation.
   - More details in [Modes section](#modes)
 - ⚡ **Runs in multiplex terminal** Run `screen -x` to attach to the terminal that the AI runs commands on. See history or interrupt process or interact with the same terminal that AI uses.
-- ⚡ **Automatically load CLAUDE.md** Loads "CLAUDE.md" file in project root and sends as instructions during initialisation. Instructions in a global "~/.wcgw/CLAUDE.md" file are loaded and added along with project specific CLAUDE.md. The file name is case sensitive. 
+- ⚡ **Automatically load CLAUDE.md/AGENTS.md** Loads "CLAUDE.md" or "AGENTS.md" file in project root and sends as instructions during initialisation. Instructions in a global "~/.wcgw/CLAUDE.md" or "~/.wcgw/AGENTS.md" file are loaded and added along with project specific CLAUDE.md. The file name is case sensitive. CLAUDE.md is attached if it's present otherwise AGENTS.md is attached.
 
 ## Top use cases examples
 
@@ -118,7 +118,7 @@ Then create or update `claude_desktop_config.json` (~/Library/Application Suppor
   "mcpServers": {
     "wcgw": {
       "command": "uv",
-      "args": ["tool", "run", "--python", "3.12", "wcgw@latest"]
+      "args": ["tool", "run", "--python", "3.12", "wcgw"]
     }
   }
 }
@@ -129,10 +129,10 @@ Then restart claude app.
 _If there's an error in setting up_
 
 - If there's an error like "uv ENOENT", make sure `uv` is installed. Then run 'which uv' in the terminal, and use its output in place of "uv" in the configuration.
-- If there's still an issue, check that `uv tool run --python 3.12 wcgw@latest` runs in your terminal. It should have no output and shouldn't exit.
+- If there's still an issue, check that `uv tool run --python 3.12 wcgw` runs in your terminal. It should have no output and shouldn't exit.
 - Try removing ~/.cache/uv folder
 - 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 --python 3.12 wcgw@latest`
+- Debug the mcp server using `npx @modelcontextprotocol/inspector@0.1.7 uv tool run --python 3.12 wcgw`
 
 ### Windows on wsl
 
@@ -147,12 +147,12 @@ Then add or update the claude config file `%APPDATA%\Claude\claude_desktop_confi
   "mcpServers": {
     "wcgw": {
       "command": "wsl.exe",
-      "args": ["uv", "tool", "run", "--python", "3.12", "wcgw@latest"]
+      "args": ["uv", "tool", "run", "--python", "3.12", "wcgw"]
     }
   }
 }
 ```
-When you encounter an error, execute the command wsl uv --python 3.12 wcgw@latest in command prompt. If you get the `error /bin/bash: line 1: uv: command not found`, it means uv was not installed globally and you need to point to the correct path of uv.
+When you encounter an error, execute the command wsl uv --python 3.12 wcgw in command prompt. If you get the `error /bin/bash: line 1: uv: command not found`, it means uv was not installed globally and you need to point to the correct path of uv.
 1. Find where uv is installed:
 ```bash
 whereis uv
@@ -162,7 +162,7 @@ Example output:
 
 2. Test the full path works:
 ```
-wsl /home/mywsl/.local/bin/uv tool run --python 3.12 wcgw@latest
+wsl /home/mywsl/.local/bin/uv tool run --python 3.12 wcgw
 ```
 
 3. Update the config with the full path:
@@ -171,7 +171,7 @@ wsl /home/mywsl/.local/bin/uv tool run --python 3.12 wcgw@latest
   "mcpServers": {
     "wcgw": {
       "command": "wsl.exe",
-      "args": ["/home/mywsl/.local/bin/uv", "tool", "run", "--python", "3.12", "wcgw@latest"]
+      "args": ["/home/mywsl/.local/bin/uv", "tool", "run", "--python", "3.12", "wcgw"]
     }
   }
 }
@@ -223,6 +223,12 @@ You can interact with the terminal but beware that the AI might be running in pa
 
 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.
 
+Include the following in ~/.screenrc for better scrolling experience
+```
+defscrollback 10000
+termcapinfo xterm* ti@:te@
+```
+
 ### [Optional] Vs code extension
 
 https://marketplace.visualstudio.com/items?itemName=AmanRusia.wcgw
@@ -267,7 +273,7 @@ Add `OPENAI_API_KEY` and `OPENAI_ORG_ID` env variables.
 
 Then run
 
-`uvx wcgw@latest wcgw_local --limit 0.1` # Cost limit $0.1
+`uvx wcgw wcgw_local --limit 0.1` # Cost limit $0.1
 
 You can now directly write messages or press enter key to open vim for multiline message and text pasting.
 
@@ -277,7 +283,7 @@ Add `ANTHROPIC_API_KEY` env variable.
 
 Then run
 
-`uvx wcgw@latest wcgw_local --claude`
+`uvx wcgw wcgw_local --claude`
 
 You can now directly write messages or press enter key to open vim for multiline message and text pasting.
 

{wcgw-5.4.3 → wcgw-5.4.4}/README.md

@@ -55,7 +55,7 @@ wcgw is an MCP server with tightly integrated shell and code editing tools.
   - By default it runs in 'wcgw' mode that has no restrictions and full authorisation.
   - More details in [Modes section](#modes)
 - ⚡ **Runs in multiplex terminal** Run `screen -x` to attach to the terminal that the AI runs commands on. See history or interrupt process or interact with the same terminal that AI uses.
-- ⚡ **Automatically load CLAUDE.md** Loads "CLAUDE.md" file in project root and sends as instructions during initialisation. Instructions in a global "~/.wcgw/CLAUDE.md" file are loaded and added along with project specific CLAUDE.md. The file name is case sensitive. 
+- ⚡ **Automatically load CLAUDE.md/AGENTS.md** Loads "CLAUDE.md" or "AGENTS.md" file in project root and sends as instructions during initialisation. Instructions in a global "~/.wcgw/CLAUDE.md" or "~/.wcgw/AGENTS.md" file are loaded and added along with project specific CLAUDE.md. The file name is case sensitive. CLAUDE.md is attached if it's present otherwise AGENTS.md is attached.
 
 ## Top use cases examples
 
@@ -87,7 +87,7 @@ Then create or update `claude_desktop_config.json` (~/Library/Application Suppor
   "mcpServers": {
     "wcgw": {
       "command": "uv",
-      "args": ["tool", "run", "--python", "3.12", "wcgw@latest"]
+      "args": ["tool", "run", "--python", "3.12", "wcgw"]
     }
   }
 }
@@ -98,10 +98,10 @@ Then restart claude app.
 _If there's an error in setting up_
 
 - If there's an error like "uv ENOENT", make sure `uv` is installed. Then run 'which uv' in the terminal, and use its output in place of "uv" in the configuration.
-- If there's still an issue, check that `uv tool run --python 3.12 wcgw@latest` runs in your terminal. It should have no output and shouldn't exit.
+- If there's still an issue, check that `uv tool run --python 3.12 wcgw` runs in your terminal. It should have no output and shouldn't exit.
 - Try removing ~/.cache/uv folder
 - 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 --python 3.12 wcgw@latest`
+- Debug the mcp server using `npx @modelcontextprotocol/inspector@0.1.7 uv tool run --python 3.12 wcgw`
 
 ### Windows on wsl
 
@@ -116,12 +116,12 @@ Then add or update the claude config file `%APPDATA%\Claude\claude_desktop_confi
   "mcpServers": {
     "wcgw": {
       "command": "wsl.exe",
-      "args": ["uv", "tool", "run", "--python", "3.12", "wcgw@latest"]
+      "args": ["uv", "tool", "run", "--python", "3.12", "wcgw"]
     }
   }
 }
 ```
-When you encounter an error, execute the command wsl uv --python 3.12 wcgw@latest in command prompt. If you get the `error /bin/bash: line 1: uv: command not found`, it means uv was not installed globally and you need to point to the correct path of uv.
+When you encounter an error, execute the command wsl uv --python 3.12 wcgw in command prompt. If you get the `error /bin/bash: line 1: uv: command not found`, it means uv was not installed globally and you need to point to the correct path of uv.
 1. Find where uv is installed:
 ```bash
 whereis uv
@@ -131,7 +131,7 @@ Example output:
 
 2. Test the full path works:
 ```
-wsl /home/mywsl/.local/bin/uv tool run --python 3.12 wcgw@latest
+wsl /home/mywsl/.local/bin/uv tool run --python 3.12 wcgw
 ```
 
 3. Update the config with the full path:
@@ -140,7 +140,7 @@ wsl /home/mywsl/.local/bin/uv tool run --python 3.12 wcgw@latest
   "mcpServers": {
     "wcgw": {
       "command": "wsl.exe",
-      "args": ["/home/mywsl/.local/bin/uv", "tool", "run", "--python", "3.12", "wcgw@latest"]
+      "args": ["/home/mywsl/.local/bin/uv", "tool", "run", "--python", "3.12", "wcgw"]
     }
   }
 }
@@ -192,6 +192,12 @@ You can interact with the terminal but beware that the AI might be running in pa
 
 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.
 
+Include the following in ~/.screenrc for better scrolling experience
+```
+defscrollback 10000
+termcapinfo xterm* ti@:te@
+```
+
 ### [Optional] Vs code extension
 
 https://marketplace.visualstudio.com/items?itemName=AmanRusia.wcgw
@@ -236,7 +242,7 @@ Add `OPENAI_API_KEY` and `OPENAI_ORG_ID` env variables.
 
 Then run
 
-`uvx wcgw@latest wcgw_local --limit 0.1` # Cost limit $0.1
+`uvx wcgw wcgw_local --limit 0.1` # Cost limit $0.1
 
 You can now directly write messages or press enter key to open vim for multiline message and text pasting.
 
@@ -246,7 +252,7 @@ Add `ANTHROPIC_API_KEY` env variable.
 
 Then run
 
-`uvx wcgw@latest wcgw_local --claude`
+`uvx wcgw wcgw_local --claude`
 
 You can now directly write messages or press enter key to open vim for multiline message and text pasting.
 

{wcgw-5.4.3 → wcgw-5.4.4}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 authors = [{ name = "Aman Rusia", email = "gapypi@arcfu.com" }]
 name = "wcgw"
-version = "5.4.3"
+version = "5.4.4"
 description = "Shell and coding agent for Claude and other mcp clients"
 readme = "README.md"
 requires-python = ">=3.11"

{wcgw-5.4.3 → wcgw-5.4.4}/src/wcgw/client/tools.py

@@ -267,7 +267,7 @@ def initialize(
         initial_files, initial_paths_with_ranges, _ = read_files(
             read_files_, coding_max_tokens, noncoding_max_tokens, context
         )
-        initial_files_context = f"---\n# Requested files\n{initial_files}\n---\n"
+        initial_files_context = f"---\n# Requested files\nHere are the contents of the requested files:\n{initial_files}\n---\n"
 
     # Check for global CLAUDE.md and workspace CLAUDE.md
     alignment_context = ""
@@ -600,7 +600,7 @@ def write_file(
                     return (
                         (
                             msg
-                            + f"Here's the existing file:\n<wcgw:file>\n{file_content_str}\n{final_message}\n</wcgw:file>"
+                            + f"Here's the existing file:\n<file-contents-numbered>\n{file_content_str}\n{final_message}\n</file-contents-numbered>"
                         ),
                         {path_: file_ranges},
                     )
@@ -622,7 +622,7 @@ def write_file(
                     return (
                         (
                             msg
-                            + f"Here's the existing file:\n<wcgw:file>\n{file_content_str}\n</wcgw:file>\n{final_message}"
+                            + f"Here's the existing file:\n<file-contents-numbered>\n{file_content_str}\n</file-contents-numbered>\n{final_message}"
                         ),
                         {path_: file_ranges},
                     )
@@ -1201,10 +1201,12 @@ def read_files(
             noncoding_max_tokens = max(0, noncoding_max_tokens - tokens)
 
         range_formatted = range_format(start_line_num, end_line_num)
-        message += f'\n<wcgw:file path="{file}{range_formatted}">\n{content}\n'
+        message += (
+            f'\n<file-contents-numbered path="{file}{range_formatted}">\n{content}\n'
+        )
 
         if not truncated:
-            message += "</wcgw:file>"
+            message += "</file-contents-numbered>"
 
         # Check if we've hit both token limit
         if (

{wcgw-5.4.3 → wcgw-5.4.4}/uv.lock

@@ -1398,7 +1398,7 @@ wheels = [
 
 [[package]]
 name = "wcgw"
-version = "5.4.3"
+version = "5.4.4"
 source = { editable = "." }
 dependencies = [
     { name = "anthropic" },