MCP App Store
by KeenEthics
Shellway: Remote PC & Terminal icon

Shellway: Remote PC & Terminal MCP Server for ChatGPT

By Sandeep Kumar Saini

Overview

Shellway lets ChatGPT work on your own computer or server, from your phone or browser, without opening ports or setting up a VPN. Install the small Shellway app on the computer you want to control (npx shellway pair YOUR-CODE). It connects out to Shellway, and ChatGPT can then: - read, write and edit files, move and rename them, create folders - search a folder by file name or by text inside files, with filters and context, including big searches in the background - run commands, and start programs that keep running (a dev server, a Python session), check on them and stop them - list your paired computers and whether they are online You stay in control. Start the app with --readonly and ChatGPT can only read, search and list. Remove a computer from your dashboard at any time. Shellway passes requests between ChatGPT and your computer and does not store your file contents or command output; it logs only the time, tool name and result. Sign in with Google. Needs Node.js 22 or newer on your computer (Linux, macOS, Windows; Linux is the most tested). Your computer must be on and running the Shellway app. Run the app as a normal user, not as an administrator.

How to connect

  1. ChatGPT: Open the Shellway: Remote PC & Terminal listing in the ChatGPT app directory and choose Connect. ChatGPT listing Shellway: Remote PC & Terminal exposes 30 tools here.

Tools

close_app

ChatGPT
Close an app window by pid or process name (see list_windows). Asks the app to close; force=true ends it without saving.

create_directory

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

download_file

ChatGPT
Download a file from a URL and save it to the computer. Max 500 MB. Creates any missing parent folders.

edit_block

ChatGPT
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).

focus_window

ChatGPT
Bring an open window to the front by pid or title (see list_windows).

force_terminate

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

get_file_info

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

get_more_search_results

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

interact_with_process

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

list_devices

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

list_directory

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

list_processes

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

list_sessions

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

list_windows

ChatGPT
List open app windows (pid, app, title) on a Windows computer.

mouse_click

ChatGPT
Windows: click at x,y screen pixels (0,0 = top-left of the main screen). button "left" (default) or "right"; double=true for a double click.

move_file

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

open_app

ChatGPT
Start an app or open a URL on the computer, e.g. name "chrome" with args "https://example.com", "notepad", "ms-settings:".

open_file

ChatGPT
Open a file or URL with the default application on the computer (like double-clicking it). Use for images, PDFs, URLs or any file you want the user to see.

press_keys

ChatGPT
Press keys or shortcuts, space-separated, e.g. "ctrl+l", "enter", "alt+tab", "ctrl+shift+t", "f5".

read_file

ChatGPT
Read a text file from the user's computer.

read_multiple_files

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

read_process_output

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

run_command

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

search_files

ChatGPT
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_process

ChatGPT
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.

take_screenshot

ChatGPT
Take a screenshot of the computer's screen (JPEG, at most 1280 px wide). macOS for now (not available on Windows yet). Works only if the owner allowed screen control on that computer.

type_text

ChatGPT
Type text into the active window (max 5000 characters). Click the field first.

write_file

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

Capabilities

Writes

Example Prompts

Click any prompt to copy it.

Similar Apps

Listed on MCP App Store

Listed on MCP App Store

Add this badge to your site or README. It links to this page.

HTML

<a href="https://mcp-app-store.keenethics-labs.com/app/shellway"><img src="https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg" alt="Listed on MCP App Store" width="220" height="44"></a>

Markdown

[![Listed on MCP App Store](https://mcp-app-store.keenethics-labs.com/badges/listed-on-mcp-app-store.svg)](https://mcp-app-store.keenethics-labs.com/app/shellway)