Shellway

Create a folder, including any missing parent folders. Does nothing if it already exists.

Replace exact text inside an existing text file. Safer than rewriting the whole file: it fails, and changes nothing, if old_string is not found or appears a different number of times than expected_replacements (default 1).

Stop a process started with start_process (and anything it started). Only processes Shellway started can be stopped this way.

Show the type, size, modified and created time and permissions of a file or folder.

Read the next results of a search started with start_search. Waits a moment if the search is still running.

Type text into a process started with start_process (add a newline to press Enter) and return what it prints next.

List the computers connected to this Shellway account and whether each is online.

List files and folders in a directory on the user's computer.

Show the programs running on the computer (pid, user, CPU, memory, running time, name), busiest first.

List the background processes that Shellway started on this computer, with their status and unread output.

Move or rename a file or folder. Refuses to overwrite: if the destination already exists nothing is moved.

Read a text file from the user's computer.

Read up to 20 text files in one call. A file that cannot be read is reported inline and does not stop the others.

Return what a background process has printed since you last read it, and whether it is still running.

Run a shell command on the user's computer and return stdout, stderr and the exit code.

Search under a folder either by file name (mode "name", supports * and ?) or by text inside files (mode "content"). Skips node_modules, .git and binary or very large files. Results are capped.

Start a command that keeps running (a dev server, a build, a Python or Node shell, an ssh session) and return its first output. Use read_process_output and interact_with_process to follow up and force_terminate to stop it. There is no terminal, so full-screen programs and password prompts will not work. At most 5 run at once; one nobody touches for 30 minutes is stopped.

Search a folder in the background by file name or by text inside files, with optional regular expression, file-type filter (for example ".js,.ts") and lines of context around each match. Returns the first results and a search_id; use get_more_search_results for the rest. Good for big folders and many matches.

Stop a search started with start_search. Results found so far can still be read.

Create or overwrite a text file on the user's computer.