• 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 (~ allowed)

• 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

• Execute a bash command. This is stateful (beware with subsequent calls).

• Status of the command and the current working directory will always be returned at the end.

• The first or the last line might be (...truncated) if the output is too long.

• Always run pwd if you get any file or directory not found error to make sure you're not lost.

• Run long running commands in background using screen instead of "&".

• Do not use 'cat' to read files, use ReadFiles tool instead

• In order to check status of previous command, use status_check with empty command argument.

• Only command is allowed to run at a time. You need to wait for any previous command to finish before running a new one.

• Programs don't hang easily, so most likely explanation for no output is usually that the program is still running, and you need to check status again.

• Do not send Ctrl-c before checking for status till 10 minutes or whatever is appropriate for the program to finish.

• Read full file content of one or more files.

• Provide absolute paths only (~ allowed)

• Only if the task requires line numbers understanding:

  • You may extract a range of lines. E.g., /path/to/file:1-10 for lines 1-10. You can drop start or end like /path/to/file:1- or /path/to/file:-10

Read an image from the shell.

• Writes or edits a file based on the percentage of changes.

• Use absolute path only (~ allowed).

• First write down percentage of lines that need to be replaced in the file (between 0-100) in percentage_to_change

• percentage_to_change should be low if mostly new code is to be added. It should be high if a lot of things are to be replaced.

• If percentage_to_change > 50, provide full file content in text_or_search_replace_blocks

• If percentage_to_change <= 50, text_or_search_replace_blocks should be search/replace blocks.

Instructions for editing files.

Example

Input file

Edit format on the input file

SEARCH/REPLACE block Rules:

• Every "SEARCH" section must EXACTLY MATCH the existing file content, character for character, including all comments, docstrings, whitespaces, etc.

• Use multiple search/replace blocks in a single FileWriteOrEdit tool call to edit in a single file in multiple places from top to bottom (separate calls are slower).

• Including multiple unique SEARCH/REPLACE blocks if needed.

• Include enough and only enough lines in each SEARCH section to uniquely match each set of lines that need to change.

• Keep SEARCH/REPLACE blocks concise.

• Break large SEARCH/REPLACE blocks into a series of smaller blocks that each change a small portion of the file.

• Include just the changing lines, and a few surrounding lines (0-3 lines) if needed for uniqueness.

• Other than for uniqueness, avoid including those lines which do not change in search (and replace) blocks. Target 0-3 non trivial extra lines per block.

• Preserve leading spaces and indentations in both SEARCH and REPLACE blocks.

Saves provided description and file contents of all the relevant file paths or globs in a single text file.

• Provide random 3 word unqiue id or whatever user provided.

• Leave project path as empty string if no project path