wcgw 3.0.1rc3__tar.gz → 3.0.2__tar.gz

{wcgw-3.0.1rc3 → wcgw-3.0.2}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: wcgw
-Version: 3.0.1rc3
+Version: 3.0.2
 Summary: Shell and coding agent on claude and chatgpt
 Project-URL: Homepage, https://github.com/rusiaaman/wcgw
 Author-email: Aman Rusia <gapypi@arcfu.com>
@@ -43,6 +43,8 @@ Empowering chat applications to code, build and run on your local machine.
 
 ## Updates
 
+- [16 Feb 2025] You can now attach to the working terminal that the AI uses. See the "attach-to-terminal" section below.
+
 - [15 Jan 2025] Modes introduced: architect, code-writer, and all powerful wcgw mode.
 
 - [8 Jan 2025] Context saving tool for saving relevant file paths along with a description in a single file. Can be used as a task checkpoint or for knowledge transfer.
@@ -51,9 +53,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)
 
-- [01 Dec 2024] Removed author hosted relay server for chatgpt.
-
-- [26 Nov 2024] Introduced claude desktop support through mcp
 
 ## 🚀 Highlights
 
@@ -100,7 +99,7 @@ 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/)
 
-Then update `claude_desktop_config.json` (~/Library/Application Support/Claude/claude_desktop_config.json)
+Then create or update `claude_desktop_config.json` (~/Library/Application Support/Claude/claude_desktop_config.json) with following json.
 
 ```json
 {
@@ -127,6 +126,8 @@ _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 --from wcgw@latest --python 3.12 wcgw_mcp` 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 --from wcgw@latest --python 3.12 wcgw_mcp`
 
 ### Alternative configuration using smithery (npx required)
@@ -139,6 +140,9 @@ Then to configure wcgw for Claude Desktop automatically via [Smithery](https://s
 npx -y @smithery/cli install wcgw --client claude
 ```
 
+_If there's an error in setting up_
+- Try removing ~/.cache/uv folder
+
 ### Usage
 
 Wait for a few seconds. You should be able to see this icon if everything goes right.
@@ -168,6 +172,21 @@ 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`
+
+And note down the wcgw screen name which will be something like `93358.wcgw.235521` where the last number is in the hour-minute-second format.
+
+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 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.
+
 ### [Optional] Vs code extension
 
 https://marketplace.visualstudio.com/items?itemName=AmanRusia.wcgw
@@ -216,7 +235,6 @@ The server provides the following MCP tools:
   - Parameters: `any_workspace_path` (string), `initial_files_to_read` (string[]), `mode_name` ("wcgw"|"architect"|"code_writer"), `task_id_to_resume` (string)
 - `BashCommand`: Execute shell commands with timeout control
   - Parameters: `command` (string), `wait_for_seconds` (int, optional)
-- `BashInteraction`: Send keyboard input to running programs
   - Parameters: `send_text` (string) or `send_specials` (["Enter"|"Key-up"|...]) or `send_ascii` (int[]), `wait_for_seconds` (int, optional)
 
 **File Operations:**
@@ -234,7 +252,5 @@ The server provides the following MCP tools:
 
 - `ContextSave`: Save project context and files for Knowledge Transfer or saving task checkpoints to be resumed later
   - Parameters: `id` (string), `project_root_path` (string), `description` (string), `relevant_file_globs` (string[])
-- `ResetShell`: Emergency reset for shell environment
-  - Parameters: `should_reset` (boolean)
 
 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.1rc3 → wcgw-3.0.2}/README.md

@@ -15,6 +15,8 @@ Empowering chat applications to code, build and run on your local machine.
 
 ## Updates
 
+- [16 Feb 2025] You can now attach to the working terminal that the AI uses. See the "attach-to-terminal" section below.
+
 - [15 Jan 2025] Modes introduced: architect, code-writer, and all powerful wcgw mode.
 
 - [8 Jan 2025] Context saving tool for saving relevant file paths along with a description in a single file. Can be used as a task checkpoint or for knowledge transfer.
@@ -23,9 +25,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)
 
-- [01 Dec 2024] Removed author hosted relay server for chatgpt.
-
-- [26 Nov 2024] Introduced claude desktop support through mcp
 
 ## 🚀 Highlights
 
@@ -72,7 +71,7 @@ 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/)
 
-Then update `claude_desktop_config.json` (~/Library/Application Support/Claude/claude_desktop_config.json)
+Then create or update `claude_desktop_config.json` (~/Library/Application Support/Claude/claude_desktop_config.json) with following json.
 
 ```json
 {
@@ -99,6 +98,8 @@ _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 --from wcgw@latest --python 3.12 wcgw_mcp` 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 --from wcgw@latest --python 3.12 wcgw_mcp`
 
 ### Alternative configuration using smithery (npx required)
@@ -111,6 +112,9 @@ Then to configure wcgw for Claude Desktop automatically via [Smithery](https://s
 npx -y @smithery/cli install wcgw --client claude
 ```
 
+_If there's an error in setting up_
+- Try removing ~/.cache/uv folder
+
 ### Usage
 
 Wait for a few seconds. You should be able to see this icon if everything goes right.
@@ -140,6 +144,21 @@ 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`
+
+And note down the wcgw screen name which will be something like `93358.wcgw.235521` where the last number is in the hour-minute-second format.
+
+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 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.
+
 ### [Optional] Vs code extension
 
 https://marketplace.visualstudio.com/items?itemName=AmanRusia.wcgw
@@ -188,7 +207,6 @@ The server provides the following MCP tools:
   - Parameters: `any_workspace_path` (string), `initial_files_to_read` (string[]), `mode_name` ("wcgw"|"architect"|"code_writer"), `task_id_to_resume` (string)
 - `BashCommand`: Execute shell commands with timeout control
   - Parameters: `command` (string), `wait_for_seconds` (int, optional)
-- `BashInteraction`: Send keyboard input to running programs
   - Parameters: `send_text` (string) or `send_specials` (["Enter"|"Key-up"|...]) or `send_ascii` (int[]), `wait_for_seconds` (int, optional)
 
 **File Operations:**
@@ -206,7 +224,5 @@ The server provides the following MCP tools:
 
 - `ContextSave`: Save project context and files for Knowledge Transfer or saving task checkpoints to be resumed later
   - Parameters: `id` (string), `project_root_path` (string), `description` (string), `relevant_file_globs` (string[])
-- `ResetShell`: Emergency reset for shell environment
-  - Parameters: `should_reset` (boolean)
 
 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.1rc3 → wcgw-3.0.2}/gpt_action_json_schema.json

@@ -90,46 +90,6 @@
         }
       }
     },
-    "/v1/reset_wcgw": {
-      "post": {
-        "x-openai-isConsequential": false,
-        "summary": "Reset Wcgw",
-        "operationId": "reset_wcgw_v1_reset_wcgw_post",
-        "requestBody": {
-          "content": {
-            "application/json": {
-              "schema": {
-                "$ref": "#/components/schemas/ResetWcgwWithUUID"
-              }
-            }
-          },
-          "required": true
-        },
-        "responses": {
-          "200": {
-            "description": "Successful Response",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "type": "string",
-                  "title": "Response Reset Wcgw V1 Reset Wcgw Post"
-                }
-              }
-            }
-          },
-          "422": {
-            "description": "Validation Error",
-            "content": {
-              "application/json": {
-                "schema": {
-                  "$ref": "#/components/schemas/HTTPValidationError"
-                }
-              }
-            }
-          }
-        }
-      }
-    },
     "/v1/bash_command": {
       "post": {
         "x-openai-isConsequential": false,
@@ -473,6 +433,16 @@
       },
       "InitializeWithUUID": {
         "properties": {
+          "type": {
+            "type": "string",
+            "enum": [
+              "first_call",
+              "user_asked_mode_change",
+              "reset_shell",
+              "user_asked_change_workspace"
+            ],
+            "title": "Type"
+          },
           "any_workspace_path": {
             "type": "string",
             "title": "Any Workspace Path"
@@ -516,6 +486,7 @@
         "additionalProperties": false,
         "type": "object",
         "required": [
+          "type",
           "any_workspace_path",
           "initial_files_to_read",
           "task_id_to_resume",
@@ -547,59 +518,6 @@
         ],
         "title": "ReadFileWithUUID"
       },
-      "ResetWcgwWithUUID": {
-        "properties": {
-          "should_reset": {
-            "type": "boolean",
-            "const": true,
-            "title": "Should Reset"
-          },
-          "change_mode": {
-            "anyOf": [
-              {
-                "type": "string",
-                "enum": [
-                  "wcgw",
-                  "architect",
-                  "code_writer"
-                ]
-              },
-              {
-                "type": "null"
-              }
-            ],
-            "title": "Change Mode"
-          },
-          "code_writer_config": {
-            "anyOf": [
-              {
-                "$ref": "#/components/schemas/CodeWriterMode"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          },
-          "starting_directory": {
-            "type": "string",
-            "title": "Starting Directory"
-          },
-          "user_id": {
-            "type": "string",
-            "format": "uuid",
-            "title": "User Id"
-          }
-        },
-        "additionalProperties": false,
-        "type": "object",
-        "required": [
-          "should_reset",
-          "change_mode",
-          "starting_directory",
-          "user_id"
-        ],
-        "title": "ResetWcgwWithUUID"
-      },
       "SendAscii": {
         "properties": {
           "send_ascii": {

{wcgw-3.0.1rc3 → wcgw-3.0.2}/gpt_instructions.txt

@@ -9,16 +9,16 @@ Instructions:
     - Do not install new tools/packages before ensuring no such tools/package or an alternative already exists.
 
 Instructions for `Initialize`:
-    - Always call this at the start of the conversation.- This will reset the shell.
-    - Use `any_workspace_path` to initialize the shell in the appropriate project directory.
-    - If the user has mentioned a workspace or project root, use it to set `any_workspace_path`.
-    - If the user has mentioned a folder or file with unclear project root, use the file or folder as `any_workspace_path`.
-    - If user has mentioned any files use `initial_files_to_read` to read, use absolute paths only.
-    - If `any_workspace_path` is provided, a tree structure of the workspace will be shown.
-    - Leave `any_workspace_path` as empty if no file or folder is mentioned.
-    - By default use mode `wcgw`
-    - In code-writer mode, set the commands and globs which user asked to set, otherwise use 'all'.
-    - Call `ResetWcgw` if you want to change the mode later.
+- Always call this at the start of the conversation before using any of the shell tools from wcgw.
+- Use `any_workspace_path` to initialize the shell in the appropriate project directory.
+- If the user has mentioned a workspace or project root or any other file or folder use it to set `any_workspace_path`.
+- If user has mentioned any files use `initial_files_to_read` to read, use absolute paths only.
+- By default use mode "wcgw"
+- In "code-writer" mode, set the commands and globs which user asked to set, otherwise use 'all'.
+- Use type="first_call" if it's the first call to this tool.
+- Use type="user_asked_mode_change" if in a conversation user has asked to change mode.
+- Use type="reset_shell" if in a conversation shell is not working after multiple tries.
+- Use type="user_asked_change_workspace" if in a conversation user asked to change workspace
 
 Instructions for `BashCommand`:
 - Execute a bash command. This is stateful (beware with subsequent calls).
@@ -40,9 +40,6 @@ Instructions for `Write if Empty`
 - Provide absolute file path only.
 - For editing existing files, use FileEdit.
 
-Instructions for `ResetWcgw`
-- Resets the shell. Use either when changing mode, or when all interrupts and prompt reset attempts have failed repeatedly.
-
 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.

{wcgw-3.0.1rc3 → wcgw-3.0.2}/pyproject.toml

@@ -1,7 +1,7 @@
 [project]
 authors = [{ name = "Aman Rusia", email = "gapypi@arcfu.com" }]
 name = "wcgw"
-version = "3.0.1rc3"
+version = "3.0.2"
 description = "Shell and coding agent on claude and chatgpt"
 readme = "README.md"
 requires-python = ">=3.11"

{wcgw-3.0.1rc3 → wcgw-3.0.2}/src/wcgw/client/bash_state/bash_state.py

@@ -8,8 +8,6 @@ import traceback
 from dataclasses import dataclass
 from typing import (
     Any,
-    Callable,
-    Concatenate,
     Literal,
     Optional,
     ParamSpec,
@@ -107,6 +105,9 @@ def cleanup_all_screens_with_name(name: str, console: Console) -> None:
         output = (e.stdout or "") + (e.stderr or "")
     except FileNotFoundError:
         return
+    except Exception as e:
+        console.log(f"{e}: exception while clearing running screens.")
+        return
 
     sessions_to_kill = []
 
@@ -130,8 +131,8 @@ def cleanup_all_screens_with_name(name: str, console: Console) -> None:
                 check=True,
                 timeout=CONFIG.timeout,
             )
-        except (subprocess.CalledProcessError, FileNotFoundError):
-            console.log(f"Failed to kill screen session: {session}")
+        except Exception as e:
+            console.log(f"Failed to kill screen session: {session}\n{e}")
 
 
 def start_shell(
@@ -217,33 +218,7 @@ P = ParamSpec("P")
 R = TypeVar("R")
 
 
-def requires_shell(
-    func: Callable[Concatenate["BashState", "pexpect.spawn[str]", P], R],
-) -> Callable[Concatenate["BashState", P], R]:
-    def wrapper(self: "BashState", /, *args: P.args, **kwargs: P.kwargs) -> R:
-        if not self._shell_loading.is_set():
-            if not self._shell_loading.wait(
-                timeout=CONFIG.timeout * 2
-            ):  # Twice in worst case if screen fails
-                raise RuntimeError("Shell initialization timeout")
-
-        if self._shell_error:
-            raise RuntimeError(f"Shell failed to initialize: {self._shell_error}.")
-
-        if not self._shell:
-            raise RuntimeError("Shell not initialized")
-
-        return func(self, self._shell, *args, **kwargs)
-
-    return wrapper
-
-
 class BashState:
-    _shell: Optional["pexpect.spawn[str]"]
-    _shell_id: Optional[str]
-    _shell_lock: threading.Lock
-    _shell_loading: threading.Event
-    _shell_error: Optional[Exception]
     _use_screen: bool
 
     def __init__(
@@ -266,67 +241,39 @@ class BashState:
         self._write_if_empty_mode: WriteIfEmptyMode = (
             write_if_empty_mode or WriteIfEmptyMode("all")
         )
-        self._mode = mode or Modes.wcgw
+        self._mode = mode or "wcgw"
         self._whitelist_for_overwrite: set[str] = whitelist_for_overwrite or set()
         self._bg_expect_thread: Optional[threading.Thread] = None
         self._bg_expect_thread_stop_event = threading.Event()
-        self._shell = None
-        self._shell_id = None
-        self._shell_lock = threading.Lock()
-        self._shell_loading = threading.Event()
-        self._shell_error = None
         self._use_screen = use_screen
-        self._start_shell_loading()
+        self._init_shell()
 
-    def _start_shell_loading(self) -> None:
-        def load_shell() -> None:
-            try:
-                with self._shell_lock:
-                    if self._shell is not None:
-                        return
-                    self._init_shell()
-                self.run_bg_expect_thread()
-            except Exception as e:
-                self._shell_error = e
-            finally:
-                self._shell_loading.set()
-
-        threading.Thread(target=load_shell).start()
-
-    @requires_shell
-    def expect(
-        self, shell: "pexpect.spawn[str]", pattern: Any, timeout: Optional[float] = -1
-    ) -> int:
+    def expect(self, pattern: Any, timeout: Optional[float] = -1) -> int:
         self.close_bg_expect_thread()
-        output = shell.expect(pattern, timeout)
+        output = self._shell.expect(pattern, timeout)
         return output
 
-    @requires_shell
-    def send(self, shell: "pexpect.spawn[str]", s: str | bytes) -> int:
+    def send(self, s: str | bytes) -> int:
         self.close_bg_expect_thread()
-        output = shell.send(s)
+        output = self._shell.send(s)
         return output
 
-    @requires_shell
-    def sendline(self, shell: "pexpect.spawn[str]", s: str | bytes) -> int:
+    def sendline(self, s: str | bytes) -> int:
         self.close_bg_expect_thread()
-        output = shell.sendline(s)
+        output = self._shell.sendline(s)
         return output
 
     @property
-    @requires_shell
-    def linesep(self, shell: "pexpect.spawn[str]") -> Any:
-        return shell.linesep
+    def linesep(self) -> Any:
+        return self._shell.linesep
 
-    @requires_shell
-    def sendintr(self, shell: "pexpect.spawn[str]") -> None:
+    def sendintr(self) -> None:
         self.close_bg_expect_thread()
-        shell.sendintr()
+        self._shell.sendintr()
 
     @property
-    @requires_shell
-    def before(self, shell: "pexpect.spawn[str]") -> Optional[str]:
-        return shell.before
+    def before(self) -> Optional[str]:
+        return self._shell.before
 
     def run_bg_expect_thread(self) -> None:
         """
@@ -337,16 +284,11 @@ class BashState:
             while True:
                 if self._bg_expect_thread_stop_event.is_set():
                     break
-                if self._shell is None:
-                    time.sleep(0.1)
-                    continue
                 output = self._shell.expect([pexpect.EOF, pexpect.TIMEOUT], timeout=0.1)
                 if output == 0:
                     break
 
-        if self._bg_expect_thread and self._bg_expect_thread.is_alive():
-            if not self._bg_expect_thread_stop_event.is_set():
-                return
+        if self._bg_expect_thread:
             self.close_bg_expect_thread()
 
         self._bg_expect_thread = threading.Thread(
@@ -363,13 +305,8 @@ class BashState:
 
     def cleanup(self) -> None:
         self.close_bg_expect_thread()
-        with self._shell_lock:
-            if self._shell:
-                self._shell.close(True)
-                if self._shell_id:
-                    cleanup_all_screens_with_name(self._shell_id, self.console)
-                self._shell = None
-                self._shell_id = None
+        self._shell.close(True)
+        cleanup_all_screens_with_name(self._shell_id, self.console)
 
     def __enter__(self) -> "BashState":
         return self
@@ -393,31 +330,24 @@ class BashState:
     def write_if_empty_mode(self) -> WriteIfEmptyMode:
         return self._write_if_empty_mode
 
-    @requires_shell
-    def ensure_env_and_bg_jobs(self, _: "pexpect.spawn[str]") -> Optional[int]:
-        return self._ensure_env_and_bg_jobs()
-
-    def _ensure_env_and_bg_jobs(self) -> Optional[int]:
-        # Do not add @requires_shell decorator here, as it will cause deadlock
-        self.close_bg_expect_thread()
-        assert self._shell is not None, "Bad state, shell is not initialized"
+    def ensure_env_and_bg_jobs(self) -> Optional[int]:
         quick_timeout = 0.2 if not self.over_screen else 1
         # First reset the prompt in case venv was sourced or other reasons.
-        self._shell.sendline(PROMPT_STATEMENT)
-        self._shell.expect(PROMPT_CONST, timeout=quick_timeout)
+        self.sendline(PROMPT_STATEMENT)
+        self.expect(PROMPT_CONST, timeout=quick_timeout)
         # Reset echo also if it was enabled
         command = "jobs | wc -l"
-        self._shell.sendline(command)
+        self.sendline(command)
         before = ""
         counts = 0
         while not _is_int(before):  # Consume all previous output
             try:
-                self._shell.expect(PROMPT_CONST, timeout=quick_timeout)
+                self.expect(PROMPT_CONST, timeout=quick_timeout)
             except pexpect.TIMEOUT:
                 self.console.print(f"Couldn't get exit code, before: {before}")
                 raise
 
-            before_val = self._shell.before
+            before_val = self.before
             if not isinstance(before_val, str):
                 before_val = str(before_val)
             assert isinstance(before_val, str)
@@ -435,7 +365,6 @@ class BashState:
 
     def _init_shell(self) -> None:
         self._state: Literal["repl"] | datetime.datetime = "repl"
-        self._is_in_docker: Optional[str] = ""
         # Ensure self._cwd exists
         os.makedirs(self._cwd, exist_ok=True)
         try:
@@ -461,10 +390,12 @@ class BashState:
 
         self._pending_output = ""
         try:
-            self._ensure_env_and_bg_jobs()
+            self.ensure_env_and_bg_jobs()
         except ValueError as e:
             self.console.log("Error while running _ensure_env_and_bg_jobs" + str(e))
 
+        self.run_bg_expect_thread()
+
     def set_pending(self, last_pending_output: str) -> None:
         if not isinstance(self._state, datetime.datetime):
             self._state = datetime.datetime.now()
@@ -480,13 +411,6 @@ class BashState:
             return "repl"
         return "pending"
 
-    @property
-    def is_in_docker(self) -> Optional[str]:
-        return self._is_in_docker
-
-    def set_in_docker(self, docker_image_id: str) -> None:
-        self._is_in_docker = docker_image_id
-
     @property
     def cwd(self) -> str:
         return self._cwd
@@ -495,11 +419,10 @@ class BashState:
     def prompt(self) -> str:
         return PROMPT_CONST
 
-    @requires_shell
-    def update_cwd(self, shell: "pexpect.spawn[str]") -> str:
-        shell.sendline("pwd")
-        shell.expect(PROMPT_CONST, timeout=0.2)
-        before_val = shell.before
+    def update_cwd(self) -> str:
+        self.sendline("pwd")
+        self.expect(PROMPT_CONST, timeout=0.2)
+        before_val = self.before
         if not isinstance(before_val, str):
             before_val = str(before_val)
         before_lines = render_terminal_output(before_val)
@@ -509,9 +432,7 @@ class BashState:
 
     def reset_shell(self) -> None:
         self.cleanup()
-        self._shell_loading.clear()
-        self._shell_error = None
-        self._start_shell_loading()
+        self._init_shell()
 
     def serialize(self) -> dict[str, Any]:
         """Serialize BashState to a dictionary for saving"""
@@ -531,7 +452,7 @@ class BashState:
             BashCommandMode.deserialize(state["bash_command_mode"]),
             FileEditMode.deserialize(state["file_edit_mode"]),
             WriteIfEmptyMode.deserialize(state["write_if_empty_mode"]),
-            Modes[str(state["mode"])],
+            state["mode"],
             state["whitelist_for_overwrite"],
         )
 
@@ -595,7 +516,7 @@ WAITING_INPUT_MESSAGE = """A command is already running. NOTE: You can't run mul
 1. Get its output using `send_ascii: [10] or send_specials: ["Enter"]`
 2. Use `send_ascii` or `send_specials` to give inputs to the running program, don't use `BashCommand` OR
 3. kill the previous program by sending ctrl+c first using `send_ascii` or `send_specials`
-4. Send the process in background using `send_specials: ["Ctrl-z"]` followed by BashCommand: `bg`
+4. Interrupt and run the process in background by re-running it using screen
 """