wcgw 5.4.3__tar.gz → 5.4.5__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wcgw
-Version: 5.4.3
+Version: 5.4.5
 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>
@@ -26,6 +26,7 @@ Requires-Dist: tree-sitter-bash>=0.23.3
 Requires-Dist: tree-sitter>=0.24.0
 Requires-Dist: typer>=0.12.5
 Requires-Dist: uvicorn>=0.31.0
+Requires-Dist: wcmatch>=10.1
 Requires-Dist: websockets>=13.1
 Description-Content-Type: text/markdown
 
@@ -86,7 +87,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 +119,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 +130,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 +148,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 +163,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 +172,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 +224,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 +274,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 +284,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.5}/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.5}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 authors = [{ name = "Aman Rusia", email = "gapypi@arcfu.com" }]
 name = "wcgw"
-version = "5.4.3"
+version = "5.4.5"
 description = "Shell and coding agent for Claude and other mcp clients"
 readme = "README.md"
 requires-python = ">=3.11"
@@ -27,6 +27,7 @@ dependencies = [
     "tree-sitter>=0.24.0",
     "tree-sitter-bash>=0.23.3",
     "mcp>=1.7.0",
+    "wcmatch>=10.1",
 ]
 
 [project.urls]

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

@@ -1,5 +1,4 @@
 import base64
-import fnmatch
 import glob
 import json
 import mimetypes
@@ -29,6 +28,7 @@ from openai.types.chat import (
 from pydantic import BaseModel, TypeAdapter, ValidationError
 from syntax_checker import Output as SCOutput
 from syntax_checker import check_syntax as raw_check_syntax
+from wcmatch import glob as wcglob
 
 from ..client.bash_state.bash_state import (
     BashState,
@@ -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 = ""
@@ -570,8 +570,8 @@ def write_file(
 
     # Validate using write_if_empty_mode after checking whitelist
     allowed_globs = context.bash_state.write_if_empty_mode.allowed_globs
-    if allowed_globs != "all" and not any(
-        fnmatch.fnmatch(path_, pattern) for pattern in allowed_globs
+    if allowed_globs != "all" and not wcglob.globmatch(
+        path_, allowed_globs, flags=wcglob.GLOBSTAR
     ):
         return (
             f"Error: updating file {path_} not allowed in current mode. Doesn't match allowed globs: {allowed_globs}",
@@ -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},
                     )
@@ -762,8 +762,8 @@ def _do_diff_edit(
 
     # Validate using file_edit_mode
     allowed_globs = context.bash_state.file_edit_mode.allowed_globs
-    if allowed_globs != "all" and not any(
-        fnmatch.fnmatch(path_, pattern) for pattern in allowed_globs
+    if allowed_globs != "all" and not wcglob.globmatch(
+        path_, allowed_globs, flags=wcglob.GLOBSTAR
     ):
         raise Exception(
             f"Error: updating file {path_} not allowed in current mode. Doesn't match allowed globs: {allowed_globs}"
@@ -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.5}/uv.lock

@@ -64,6 +64,15 @@ wheels = [
     { url = "https://files.pythonhosted.org/packages/a2/ee/3fd29bf416eb4f1c5579cf12bf393ae954099258abd7bde03c4f9716ef6b/autoflake-2.3.1-py3-none-any.whl", hash = "sha256:3ae7495db9084b7b32818b4140e6dc4fc280b712fb414f5b8fe57b0a8e85a840", size = 32483, upload-time = "2024-03-13T03:41:26.969Z" },
 ]
 
+[[package]]
+name = "bracex"
+version = "2.6"
+source = { registry = "https://pypi.org/simple" }
+sdist = { url = "https://files.pythonhosted.org/packages/63/9a/fec38644694abfaaeca2798b58e276a8e61de49e2e37494ace423395febc/bracex-2.6.tar.gz", hash = "sha256:98f1347cd77e22ee8d967a30ad4e310b233f7754dbf31ff3fceb76145ba47dc7", size = 26642, upload-time = "2025-06-22T19:12:31.254Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/9d/2a/9186535ce58db529927f6cf5990a849aa9e052eea3e2cfefe20b9e1802da/bracex-2.6-py3-none-any.whl", hash = "sha256:0b0049264e7340b3ec782b5cb99beb325f36c3782a32e36e876452fd49a09952", size = 11508, upload-time = "2025-06-22T19:12:29.781Z" },
+]
+
 [[package]]
 name = "certifi"
 version = "2025.4.26"
@@ -1398,7 +1407,7 @@ wheels = [
 
 [[package]]
 name = "wcgw"
-version = "5.4.3"
+version = "5.4.5"
 source = { editable = "." }
 dependencies = [
     { name = "anthropic" },
@@ -1421,6 +1430,7 @@ dependencies = [
     { name = "tree-sitter-bash" },
     { name = "typer" },
     { name = "uvicorn" },
+    { name = "wcmatch" },
     { name = "websockets" },
 ]
 
@@ -1466,6 +1476,7 @@ requires-dist = [
     { name = "tree-sitter-bash", specifier = ">=0.23.3" },
     { name = "typer", specifier = ">=0.12.5" },
     { name = "uvicorn", specifier = ">=0.31.0" },
+    { name = "wcmatch", specifier = ">=10.1" },
     { name = "websockets", specifier = ">=13.1" },
 ]
 
@@ -1489,6 +1500,18 @@ types = [
     { name = "types-toml", specifier = ">=0.10.8.20240310" },
 ]
 
+[[package]]
+name = "wcmatch"
+version = "10.1"
+source = { registry = "https://pypi.org/simple" }
+dependencies = [
+    { name = "bracex" },
+]
+sdist = { url = "https://files.pythonhosted.org/packages/79/3e/c0bdc27cf06f4e47680bd5803a07cb3dfd17de84cde92dd217dcb9e05253/wcmatch-10.1.tar.gz", hash = "sha256:f11f94208c8c8484a16f4f48638a85d771d9513f4ab3f37595978801cb9465af", size = 117421, upload-time = "2025-06-22T19:14:02.49Z" }
+wheels = [
+    { url = "https://files.pythonhosted.org/packages/eb/d8/0d1d2e9d3fabcf5d6840362adcf05f8cf3cd06a73358140c3a97189238ae/wcmatch-10.1-py3-none-any.whl", hash = "sha256:5848ace7dbb0476e5e55ab63c6bbd529745089343427caa5537f230cc01beb8a", size = 39854, upload-time = "2025-06-22T19:14:00.978Z" },
+]
+
 [[package]]
 name = "wcwidth"
 version = "0.2.13"