Developer Tools

Light Remote

by Thái Duy

Overview

Light Remote lets users connect ChatGPT to explicitly authorized devices they own, inspect device topology and effective policy, open durable sessions, work with files and Git, run bounded commands and managed processes, use real PTY/ConPTY terminals, recover job output after interruptions, and manage Main/Fleet device authority without silently switching targets.

Tools

light_remote_cancel_search

ChatGPT

Cancel one in-progress remote file search. This stops that search job but does not modify user files.

light_remote_close_session

ChatGPT

Close one session after work is complete.

light_remote_connection_helper

ChatGPT

Start here. Handles Local Wall A/B pairing and, when ready, returns/reuses the working context plus a compact tool-family menu. Call again with helperGroup=workspace|files|shell|transfer|desktop only when detailed syntax for that family is needed. OAuth account login alone never authorizes a device.

light_remote_context

ChatGPT

Reuse or create the durable working session for one A/B-authorized device, optionally changing workspace or grace. Never silently switches to an unauthorized target.

light_remote_copy_path

ChatGPT

Copy one allowed file or directory to another allowed path. Overwrite can replace destination data when explicitly requested.

light_remote_delete_path

ChatGPT

Delete one allowed file or directory. Recursive deletion must be explicitly requested and can be irreversible.

light_remote_desktop

ChatGPT

Read Real Remote V2 desktop session status for the selected Light Remote session without attaching or sending input.

light_remote_desktop_attach

ChatGPT

Attach a bounded Real Remote V2 desktop observation session. This creates observation state but does not send keyboard or pointer input.

light_remote_desktop_click

ChatGPT

Click the OS pointer once or a bounded number of times, optionally at given coordinates. This tool performs only this named OS operation, optionally followed by a bounded UI state observation. Device-local approval remains mandatory.

light_remote_desktop_detach

ChatGPT

Detach one existing Real Remote V2 desktop observation session. This stops observation state and does not alter desktop content.

light_remote_desktop_drag

ChatGPT

Drag the OS pointer from an explicit starting point to an ending point. This tool performs only this named OS operation, optionally followed by a bounded UI state observation. Device-local approval remains mandatory.

light_remote_desktop_frame

ChatGPT

Read one bounded desktop frame for bootstrap or resynchronization without sending keyboard or pointer input.

light_remote_desktop_launch_app

ChatGPT

Launch one installed macOS application by bundle identifier (macOS only). This tool performs only this named OS operation, optionally followed by a bounded UI state observation. Device-local approval remains mandatory.

light_remote_desktop_live_close

ChatGPT

Close one live semantic observation lane. This stops observation state and does not alter desktop content.

light_remote_desktop_live_open

ChatGPT

Open a bounded live semantic observation lane for an authorized desktop. This creates observation state and sends no keyboard or pointer input.

light_remote_desktop_live_read

ChatGPT

Read already-buffered semantic deltas/snapshot from the Hub cache without dispatching a new Windows observation job.

light_remote_desktop_move

ChatGPT

Move the pointer to one screen coordinate. This tool performs only this named OS operation, optionally followed by a bounded UI state observation. Device-local approval remains mandatory.

light_remote_desktop_observe

ChatGPT

Read one bounded Real Remote V2 observation from an authorized desktop without sending input.

light_remote_desktop_press_key

ChatGPT

Press one native key with explicitly enumerated modifiers. This tool performs only this named OS operation, optionally followed by a bounded UI state observation. Device-local approval remains mandatory.

light_remote_desktop_resume

ChatGPT

Resume one existing Real Remote V2 desktop observation session without sending user input.

light_remote_desktop_scroll

ChatGPT

Scroll the pointer wheel by a bounded signed delta. This tool performs only this named OS operation, optionally followed by a bounded UI state observation. Device-local approval remains mandatory.

light_remote_desktop_type_text

ChatGPT

Type Unicode text using the native OS keyboard input. This tool performs only this named OS operation, optionally followed by a bounded UI state observation. Device-local approval remains mandatory.

light_remote_desktop_windows

ChatGPT

Read the visible window inventory from the authorized remote desktop without sending input.

light_remote_desktop_write_text

ChatGPT

Write Unicode text into the focused application using native OS input. This tool performs only this named OS operation, optionally followed by a bounded UI state observation. Device-local approval remains mandatory.

light_remote_edit_file

ChatGPT

Replace an exact text block and fail if the expected replacement count is not met.

light_remote_exec

ChatGPT

Run one logical shell/PowerShell job. Prefer structured tools first; device policy re-infers capabilities before spawn.

light_remote_filesystem

ChatGPT

Create one directory inside the device allowed roots. Local device policy remains the final authorization boundary.

light_remote_hold_session

ChatGPT

Place one existing durable session on hold during an intentional transport interruption. The session can be resumed later.

light_remote_inspect_device

ChatGPT

Read policy, connection, routing, Main/Fleet, update and capability state for one owned device.

light_remote_job

ChatGPT

Read an existing job instead of repeating an operation.

light_remote_list_devices

ChatGPT

List only devices that this plugin client has explicitly paired through Local Wall A/B approval. Targeting remains explicit; no silent fallback.

light_remote_list_files

ChatGPT

List an allowed directory on the selected session target.

light_remote_list_processes

ChatGPT

List managed non-PTY processes owned by the current Light Remote session without changing them.

light_remote_list_sessions

ChatGPT

List account-scoped sessions owned by this MCP connection for recovery and continuation. Supply sessionId to read one exact session.

light_remote_list_terminals

ChatGPT

List PTY/ConPTY terminals owned by the current Light Remote session without changing them.

light_remote_move_path

ChatGPT

Move or rename one allowed file or directory. The source path is removed as part of the move.

light_remote_open_session

ChatGPT

Bind work to one explicit owned device and this MCP client.

light_remote_output

ChatGPT

Read bounded stdout/stderr by byte offset.

light_remote_process

ChatGPT

Start one persistent non-PTY process on the selected device. The command may change local or external state according to the script and device policy.

light_remote_process_input

ChatGPT

Send bounded stdin data to one existing managed process. Input can cause the process to change local or external state.

light_remote_process_output

ChatGPT

Read a bounded stdout or stderr range from one existing managed process without changing the process.

light_remote_read_file

ChatGPT

Read a bounded text range from an allowed path.

light_remote_read_multiple_files

ChatGPT

Read bounded text from multiple allowed files in one structured read-only operation.

light_remote_recent_activity

ChatGPT

Read a sanitized recent activity view for one owned device.

light_remote_remove_device

ChatGPT

Permanently remove an owned device enrollment record. Re-enrollment requires local A/B approval again.

light_remote_resize_terminal

ChatGPT

Change the rows and columns of one existing PTY/ConPTY terminal without executing a command.

light_remote_revoke_device

ChatGPT

Revoke remote authority for an owned non-integrated device. Requires explicit user intent.

light_remote_scp

ChatGPT

Begin one resumable Light SCP upload to an allowed destination. Data is staged until commit and integrity is verified with SHA-256.

light_remote_scp_download

ChatGPT

Begin one resumable Light SCP download from an allowed remote path and return transfer metadata with SHA-256 integrity information.

light_remote_scp_download_cancel

ChatGPT

Cancel one in-progress Light SCP download and discard its transfer state without modifying the remote source file.

light_remote_scp_download_chunk

ChatGPT

Read one indexed chunk from an existing Light SCP download without changing the source file.

light_remote_scp_download_status

ChatGPT

Read status and integrity metadata for one existing Light SCP download.

light_remote_scp_upload_cancel

ChatGPT

Cancel one in-progress Light SCP upload and discard staged transfer data before commit.

light_remote_scp_upload_chunk

ChatGPT

Stage one indexed data chunk for an existing Light SCP upload. This changes transfer state but does not commit the destination file.

light_remote_scp_upload_commit

ChatGPT

Verify and commit one completed Light SCP upload to its destination. If overwrite was requested, existing destination data can be replaced.

light_remote_scp_upload_status

ChatGPT

Read status and integrity metadata for one existing Light SCP upload.

light_remote_search_files

ChatGPT

Start one bounded file-name or text-content search inside an allowed path on the selected device. Use the returned search identifier with the results tool.

light_remote_search_results

ChatGPT

Read a bounded page of results from an existing remote file search without changing files.

light_remote_semantic_attach

ChatGPT

Attach a bounded semantic desktop provider for structured UI observation. This creates observation state and does not send input.

light_remote_semantic_click

ChatGPT

Click a named semantic UI control. This tool performs only this named operation. Optional await observes one declared UI state after the action. Device-local approval remains mandatory.

light_remote_semantic_collapse

ChatGPT

Collapse a named semantic UI node (Windows UIA). This tool performs only this named operation. Optional await observes one declared UI state after the action. Device-local approval remains mandatory.

light_remote_semantic_detach

ChatGPT

Detach one semantic observation session. This stops observation state and does not alter desktop content.

light_remote_semantic_events

ChatGPT

Read bounded semantic UI events after a sequence number without changing the remote desktop.

light_remote_semantic_expand

ChatGPT

Expand a named semantic UI node (Windows UIA). This tool performs only this named operation. Optional await observes one declared UI state after the action. Device-local approval remains mandatory.

light_remote_semantic_focus

ChatGPT

Focus a named semantic UI element. This tool performs only this named operation. Optional await observes one declared UI state after the action. Device-local approval remains mandatory.

light_remote_semantic_invoke

ChatGPT

Press a named semantic UI control. This tool performs only this named operation. Optional await observes one declared UI state after the action. Device-local approval remains mandatory.

light_remote_semantic_select

ChatGPT

Select a named semantic UI option (Windows UIA). This tool performs only this named operation. Optional await observes one declared UI state after the action. Device-local approval remains mandatory.

light_remote_semantic_snapshot

ChatGPT

Read one structured semantic UI snapshot from an existing authorized semantic observation session.

light_remote_semantic_toggle

ChatGPT

Toggle a named semantic checkbox or switch (Windows UIA). This tool performs only this named operation. Optional await observes one declared UI state after the action. Device-local approval remains mandatory.

light_remote_semantic_value

ChatGPT

Set the text value of a named semantic UI element. This tool performs only this named operation. Optional await observes one declared UI state after the action. Device-local approval remains mandatory.

light_remote_session_control

ChatGPT

Resume one existing durable session that is on hold. This changes session state but does not switch devices or authorize a new target.

light_remote_set_main_device

ChatGPT

Select an owned online device as Main and move current Fleet authority to it.

light_remote_signal_terminal

ChatGPT

Send interrupt, terminate, or kill to the process group owned by one terminal. Terminate or kill can discard running work.

light_remote_stat_path

ChatGPT

Read bounded metadata for one allowed path without requiring write scope.

light_remote_stop_process

ChatGPT

Stop one managed process. Force mode may terminate it immediately and can discard in-process work.

light_remote_stop_terminal

ChatGPT

Stop one PTY/ConPTY terminal. Force mode may terminate its process group immediately and can discard running work.

light_remote_terminal

ChatGPT

Start one interactive terminal session on the selected device. Starting the terminal changes session state but does not itself execute user commands.

light_remote_terminal_input

ChatGPT

Send bounded text or control input to one existing PTY/ConPTY terminal. Input can execute commands that change local or external state.

light_remote_terminal_output

ChatGPT

Read a bounded output range from one existing PTY/ConPTY terminal without sending input.

light_remote_write_file

ChatGPT

Rewrite or append text on an allowed path.

Capabilities

Writes

Links

Documentation ↗Privacy Policy ↗

App Stats

Tools

ChatGPT

Platforms