cancel_taichu_task
ChatGPTUse when the user asks to cancel a Taichu task. Requests cancellation of the returned task ID and reports the outcome; it does not undo completed effects or guarantee that every program started by the task has stopped.
copy_file
ChatGPTUse only when the user asks to copy a file or folder inside a shared folder. Never overwrites: the destination must not exist. Requires Change files for this folder; ChatGPT confirmations and protected-action checks still apply.
create_folder
ChatGPTUse only when the user asks to create a folder in a shared folder. Creates missing parent folders and fails if it already exists. Requires Change files for this folder; ChatGPT confirmations and protected-action checks still apply.
delete_file
ChatGPTUse only when the user asks to delete a file or folder in a shared folder. Moves it to the computer’s Recycle Bin (restore_file brings it back); requires Change files; ChatGPT confirmations and protected-action checks still apply.
disconnect_pc
ChatGPTUse only when the user explicitly asks to disconnect their computer from GWC Bridge. Reconnection requires supported owner controls on the PC or in GWC Web or Mobile, not a ChatGPT tool. Wait for the PC-reported state. Disconnect does not shut down the computer, revoke this connection, undo changes or guarantee cancellation of work already started.
edit_file
ChatGPTUse only when the user asks to modify an existing file. Applies exact text replacements using the file’s current SHA-256. Each oldText must match exactly once, including line endings (for example LF versus CRLF); copy it from read_file without normalizing it. If a conflict is returned, read the file again and review the current content and hash before any manual retry; never retry automatically. One call carries up to 60 KB of edits (at most 100 replacements). Requires Change files for this folder; ChatGPT confirmations and protected-action checks still apply.
end_system_process
ChatGPTUse only when the user explicitly asks to end a program on the computer. Needs the pid, createdAt and exe from list_system_processes so no other process is ended; requires Manage system processes; ChatGPT app permissions control its confirmation, and protected-action checks still apply. System-critical processes, GWC and VS Code are refused.
get_file_info
ChatGPTUse when the user asks for file or folder information without returning its contents. Returns type, size and dates, plus SHA-256 (files up to 64 MiB), text line count, PDF pages or workbook sheets when available. The file may be read to derive that information.
get_pc_settings
ChatGPTUse when the user asks to inspect current settings on an already authorized GWC computer. Do not look up settings solely to fulfill a request to share an ungranted folder or enable Commands: explain supported owner controls instead; this tool cannot grant access, share folders or enable Commands. Returns the PC-reported name (separate from its account display label), version, secret-file protection, activity log, legacy optional PC Ask observations and shared-folder capabilities, never paths or credentials. Current GWC keeps optional PC Ask off. A settings read does not change settings or certify future access.
get_prompts
ChatGPTUse when the user asks for a ready-made GWC workflow, such as a system health check, a project overview or a TODO review. Returns one approved workflow prompt from GWC’s fixed catalogue.
get_recent_activity
ChatGPTUse when the user asks what ChatGPT did on their computer. Returns, newest first, this connection’s recent changes, commands, processes and tasks with their approval and outcome, as recorded in the computer’s activity log while it is on; the user can turn the log off on the computer, and actions taken while it is off are not recorded. Read-only calls are never recorded, and entries never hold file content or command output.
get_search_results
ChatGPTUse when the user wants the results of a search started with start_search. Returns one page of matches from offset (reading does not consume them), how many were found so far and whether the search is still running.
get_status
ChatGPTUse when the user asks about their existing GWC Bridge connection, reachability or permissions. Not a default connectivity preflight for self-contained text questions or a request solely to expand access. Reports reachability, available PC information, folder reports, permissions, limits and counters for state-changing calls. Folder reports may be cached even while offline and do not confirm a successful file read or ongoing access.
get_taichu_task
ChatGPTUse when the user asks how a Taichu task is going. Returns status, retained progress events after sinceSeq and, when available, a summary and metadata-observed changes in the selected folder. These observations do not prove task authorship or content equality. Incomplete scans omit changedFiles; an empty list is not proof that no content changed.
get_usage_stats
ChatGPTUse when the user asks for this connection’s recorded activity counts today (UTC). Returns available counters for admitted calls to state-changing tools, including failures, per-tool counts and the rate limit. Read-only calls are excluded. Fallback counters can be partial; these are not proof of every completed change.
give_feedback
ChatGPTUse only when the user asks to send feedback about GWC to the GWC team. Sends their short message (at most 2,000 characters) to GWC support; nothing else from the computer or the conversation is attached.
list_devices
ChatGPTUse when the user asks to list authorized computers for this connection or choose which is online for permitted work. An explicitly unshared computer is outside this connection: if the sole request targets it, explain owner-granted access instead of probing inventory. Lists only shared computers and online status; never local paths.
list_files
ChatGPTUse when the user wants to browse a shared folder. Lists up to 1,000 files and subfolders per page at a relative path, optionally several levels deep, without changing them.
list_folders
ChatGPTUse when the user asks to see or choose folders already available to this connection through GWC Studio or GWC for VS Code for authorized work. It cannot share new folders or enable Commands; if that is the sole request, explain supported owner controls without an inventory lookup. Results are limited by this connection’s grant and PC folder policy. Returns folder IDs, Change files/Commands capabilities and legacy optional PC Ask observations, not local paths. Current GWC keeps optional PC Ask off; connection permissions, ChatGPT confirmations and protected-action checks still apply.
list_searches
ChatGPTUse when the user asks which searches this connection has on the computer. Lists their IDs, folders, state and match counts; never file content.
list_sessions
ChatGPTUse when the user asks which processes this ChatGPT connection started on the computer. Lists up to 200 retained terminal sessions. An oversized result is refused, not silently shortened.
list_system_processes
ChatGPTUse when the user asks what is running on the computer. Lists up to 500 processes with ID, name, start time, CPU and memory; filter narrows by name.
move_file
ChatGPTUse only when the user asks to move or rename a file or folder inside a shared folder. Never overwrites: the destination must not exist. Requires Change files for this folder; ChatGPT confirmations and protected-action checks still apply.
ping
ChatGPTUse when the user asks whether their computer is reachable through GWC. Checks whether the selected computer (by default the one online) is connected right now; changes nothing.
read_document
ChatGPTUse when the user asks to read a PDF, Word, Excel or PowerPoint document, or to look at a PNG, JPEG, GIF or WebP image, in a shared folder. Returns text a page or sheet at a time, spreadsheet cells as a table, or the image.
read_file
ChatGPTUse when the user asks to inspect a file in a shared folder. Reads up to 256 KB by default (limit up to 1 MiB) and returns content, encoding, size, SHA-256 and whether it was truncated. Read a large file in parts by byte offset, by lines with startLine and lineCount, or its last lines with tail.
read_multiple_files
ChatGPTUse when the user wants several files from one shared folder at once (up to 20). Returns each file’s content or its own error; together at most 1 MiB.
read_process_output
ChatGPTUse when the user wants the output of a process started with start_process. Returns output after sinceSeq, optionally waiting up to 30 seconds for more, and whether the process has exited.
restore_file
ChatGPTUse only when the user asks to bring back a file or folder that GWC deleted from this shared folder. Restores it to its original path, which must be free. Requires Change files for this folder; ChatGPT confirmations and protected-action checks still apply.
run_command
ChatGPTUse only when the user explicitly asks to run a command. It runs on the computer with the user’s operating-system permissions from a working directory inside the shared folder and may modify files, start processes or use the network. Requires Commands for this folder; ChatGPT app permissions control its confirmation, and protected-action checks still apply.
search_files
ChatGPTUse when the user asks to find text or files in a shared folder. Searches file contents for text or a regular expression, or file names, and returns up to 200 matches per page.
send_process_input
ChatGPTUse only when the user asks to type into a process started with start_process. Sends up to 16 KB as input to that program. The input may execute code, change files or contact the network with the program’s rights and is not limited to the shared folder. Do not resend automatically; include \n to press Enter.
set_pc_settings
ChatGPTUse only when the user asks to change the name reported by GWC Studio or GWC for VS Code on their computer, or keep its GWC activity log longer. This tool changes the PC-reported name, not the separate account display label shown in owner controls, and lengthens retention; it cannot shorten retention or change secret-file protection, logging, Ask on this PC, capabilities or folder sharing. Other changes require the applicable supported owner controls; this tool cannot add permission.
start_process
ChatGPTUse only when the user asks to start a long-running or interactive program, such as a dev server, a watcher or a REPL. Starts it in a terminal session on the computer with the user’s operating-system permissions and returns a session ID. Requires Commands for this folder; ChatGPT app permissions control its confirmation, and protected-action checks still apply.
start_search
ChatGPTUse when the user wants a longer or larger search of a shared folder whose results are read in pages. Starts a temporary search of file contents (text or regular expression) or file names on the computer and returns its search ID; results stay only in the computer’s memory and expire after 15 minutes.
start_taichu_task
ChatGPTUse only when the user asks to delegate a multi-step task to Taichu on their computer. The task starts in the granted folder but can change files, run programs and use the network with the user’s operating-system rights; it is not confined to that folder. It uses the user’s own Taichu configuration and may use the user’s own balance or API keys. Requires Taichu tasks permission; ChatGPT confirmation and Taichu’s own protected-action checks still apply. Returns a task ID, not a completed result.
stop_process
ChatGPTUse when the user asks to stop a process started with start_process. Requests cleanup of that exact session. The receipt reports the PC’s cleanup request outcome; process exit and descendant termination require separate evidence.
stop_search
ChatGPTUse when the user wants to cancel a search started with start_search or no longer needs its results. Stops it and discards its results on the computer; repeating it is harmless.
who_am_i
ChatGPTUse when the user asks which GWC account and connection are in use. Returns the connection label and current scopes, with account email, approval time and token expiry when available; never internal IDs or tokens. Missing identity details are unknown, and an app label alone does not uniquely identify a connection.
write_document
ChatGPTUse only when the user asks to create or replace a Word (docx), Excel (xlsx) or PDF document in a shared folder. Give docx/pdf as blocks (headings, paragraphs, lists, tables) and xlsx as sheets of cells. PDF text must be WinAnsi-compatible Western text; unsupported characters such as Chinese or emoji are refused before creating or replacing the destination. Pass expectedSha256 null to create, or the current SHA-256 to replace. At most 60 KB per call. Requires Change files for this folder; ChatGPT confirmations and protected-action checks still apply.
write_file
ChatGPTUse only when the user asks to create, replace or append to a file in a shared folder. Pass expectedSha256 null to create (the file must not exist) or the current SHA-256 from read_file to replace or append. One call carries up to 60 KB. Requires Change files for this folder; ChatGPT confirmations and protected-action checks still apply.