wcgw 5.4.2__tar.gz → 5.4.4__tar.gz

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

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wcgw
-Version: 5.4.2
+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.2 → 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.2 → wcgw-5.4.4}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 authors = [{ name = "Aman Rusia", email = "gapypi@arcfu.com" }]
 name = "wcgw"
-version = "5.4.2"
+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.2 → wcgw-5.4.4}/src/wcgw/client/bash_state/bash_state.py

@@ -4,6 +4,7 @@ import os
 import platform
 import random
 import subprocess
+import tempfile
 import threading
 import time
 import traceback
@@ -65,7 +66,7 @@ def is_mac() -> bool:
 def get_tmpdir() -> str:
     current_tmpdir = os.environ.get("TMPDIR", "")
     if current_tmpdir or not is_mac():
-        return current_tmpdir
+        return tempfile.gettempdir()
     try:
         # Fix issue while running ocrmypdf -> tesseract -> leptonica, set TMPDIR
         # https://github.com/tesseract-ocr/tesseract/issues/4333
@@ -78,7 +79,7 @@ def get_tmpdir() -> str:
     except (subprocess.CalledProcessError, FileNotFoundError):
         return "//tmp"
     except Exception:
-        return ""
+        return tempfile.gettempdir()
 
 
 def check_if_screen_command_available() -> bool:

{wcgw-5.4.2 → 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 = ""
@@ -279,29 +279,38 @@ def initialize(
     except Exception:
         pass
 
-    # First check for global CLAUDE.md in ~/.wcgw/CLAUDE.md
-    global_alignment_file_path = os.path.join(expanduser("~"), ".wcgw", "CLAUDE.md")
-    if os.path.exists(global_alignment_file_path):
-        try:
-            with open(global_alignment_file_path, "r") as f:
-                global_alignment_content = f.read()
-            alignment_context += f"---\n# Important guidelines from the user\n```\n{global_alignment_content}\n```\n---\n\n"
-        except Exception:
-            # Handle any errors when reading the global file
-            pass
+    # Check for global alignment doc in ~/.wcgw: prefer CLAUDE.md, else AGENTS.md
+    try:
+        global_dir = os.path.join(expanduser("~"), ".wcgw")
+        for fname in ("CLAUDE.md", "AGENTS.md"):
+            global_alignment_file_path = os.path.join(global_dir, fname)
+            if os.path.exists(global_alignment_file_path):
+                with open(global_alignment_file_path, "r") as f:
+                    global_alignment_content = f.read()
+                alignment_context += f"---\n# Important guidelines from the user\n```\n{global_alignment_content}\n```\n---\n\n"
+                break
+    except Exception as e:
+        # Log any errors when reading the global file
+        context.console.log(f"Error reading global alignment file: {e}")
 
-    # Then check for workspace-specific CLAUDE.md
+    # Then check for workspace-specific alignment doc: prefer CLAUDE.md, else AGENTS.md
     if folder_to_start:
-        alignment_file_path = os.path.join(folder_to_start, "CLAUDE.md")
-        if os.path.exists(alignment_file_path):
-            try:
-                # Read the CLAUDE.md file content
-                with open(alignment_file_path, "r") as f:
-                    alignment_content = f.read()
-                alignment_context += f"---\n# CLAUDE.md - user shared project guidelines to follow\n```\n{alignment_content}\n```\n---\n\n"
-            except Exception:
-                # Handle any errors when reading the file
-                pass
+        try:
+            base_dir = str(folder_to_start)
+            selected_name = ""
+            alignment_content = ""
+            for fname in ("CLAUDE.md", "AGENTS.md"):
+                alignment_file_path = os.path.join(base_dir, fname)
+                if os.path.exists(alignment_file_path):
+                    with open(alignment_file_path, "r") as f:
+                        alignment_content = f.read()
+                    selected_name = fname
+                    break
+            if alignment_content:
+                alignment_context += f"---\n# {selected_name} - user shared project guidelines to follow\n```\n{alignment_content}\n```\n---\n\n"
+        except Exception as e:
+            # Log any errors when reading the workspace file
+            context.console.log(f"Error reading workspace alignment file: {e}")
 
     uname_sysname = os.uname().sysname
     uname_machine = os.uname().machine
@@ -591,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},
                     )
@@ -613,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},
                     )
@@ -1192,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 (