Verified command catalog for build 2026110701 on Windows, macOS and Linux. Check --version and --help-json on your installed executable.
Sound and microphone
RDP: --audio-mode client|host|off and --microphone-mode client|host|off independently select playback and microphone source for a new connection. They do not start recording. The host route requires the matching service on the controlled Windows computer; it is unavailable on Linux. X11/VNC have no product audio channel.
rdp-cli host-microphone install#
Install and start the controlled-computer microphone helper on this Windows PC
A session is not required; optional session selection is listed below where supported.
rdp-cli host-microphone install --help
rdp-cli host-microphone status#
Check whether the controlled-computer microphone helper is installed on this Windows PC
A session is not required; optional session selection is listed below where supported.
rdp-cli host-microphone status --help
rdp-cli host-microphone uninstall#
Stop and remove the controlled-computer microphone helper from this Windows PC
A session is not required; optional session selection is listed below where supported.
rdp-cli host-microphone uninstall --help
rdp-cli audio status#
Get session audio capabilities and sources
Requires --session SESSION.
rdp-cli audio status --help
rdp-cli audio mute#
Mute or unmute one viewer
Requires --session SESSION.
rdp-cli audio mute --help
rdp-cli audio volume#
Set one viewer's playback gain
Requires --session SESSION.
rdp-cli audio volume --help
rdp-cli audio microphone#
Query or stop an active microphone source
Requires --session SESSION.
rdp-cli audio microphone --help
rdp-cli audio android#
Select phone playback, phone microphone or off explicitly.
Requires a current Android-enabled download for Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) or Linux (x86_64 / ARM64).
Requires --session SESSION.
rdp-cli audio android --help
rdp-cli audio poll#
Read a bounded batch of recent PCM audio samples.
Requires --session SESSION.
rdp-cli audio poll --help
Android phones
Use an explicit device ID and usb or wifi transport. Discovery does not authorize a phone. Pair through the phone’s pairing port; connection uses its separate connection port. Send the pairing code through stdin and close the stream. Save an identity only explicitly. Input and app changes require control and a fresh observation; query application jobs before repeating an uncertain operation.
rdp-cli android devices#
Discover USB and Wi-Fi candidates without authorizing them.
Requires a current Android-enabled download for Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) or Linux (x86_64 / ARM64).
A session is not required; optional session selection is listed below where supported.
rdp-cli android devices --help
rdp-cli android pair#
Pair wireless debugging using the pairing port and a code supplied through stdin.
Requires a current Android-enabled download for Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) or Linux (x86_64 / ARM64).
A session is not required; optional session selection is listed below where supported.
rdp-cli android pair --help
rdp-cli android forget#
Forget one saved local Android identity; phone-side revocation is separate.
Requires a current Android-enabled download for Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) or Linux (x86_64 / ARM64).
A session is not required; optional session selection is listed below where supported.
rdp-cli android forget --help
rdp-cli android apps list#
List installed Android packages.
Requires a current Android-enabled download for Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) or Linux (x86_64 / ARM64).
Requires --session SESSION.
rdp-cli android apps list --help
rdp-cli android apps info#
Read the actual installed paths for a package.
Requires a current Android-enabled download for Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) or Linux (x86_64 / ARM64).
Requires --session SESSION.
rdp-cli android apps info --help
rdp-cli android apps install#
Submit one APK from the authorized device directory; track its job.
Requires a current Android-enabled download for Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) or Linux (x86_64 / ARM64).
Requires --session SESSION.
rdp-cli android apps install --help
rdp-cli android apps launch#
Launch a package and verify its screen.
Requires a current Android-enabled download for Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) or Linux (x86_64 / ARM64).
Requires --session SESSION.
rdp-cli android apps launch --help
rdp-cli android apps stop#
Force-stop the explicitly selected Android package.
Requires a current Android-enabled download for Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) or Linux (x86_64 / ARM64).
Requires --session SESSION.
rdp-cli android apps stop --help
rdp-cli android apps status#
Query an app job without repeating its operation.
Requires a current Android-enabled download for Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) or Linux (x86_64 / ARM64).
Requires --session SESSION.
rdp-cli android apps status --help
rdp-cli android touch#
Send a complete timed touch gesture using a fresh screenshot.
Requires a current Android-enabled download for Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) or Linux (x86_64 / ARM64).
Requires --session SESSION.
rdp-cli android touch --help
rdp-cli android key#
Press an Android system key with control and a fresh observation.
Requires a current Android-enabled download for Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) or Linux (x86_64 / ARM64).
Requires --session SESSION.
rdp-cli android key --help
rdp-cli android text#
Explicitly paste Unicode through the phone clipboard.
Requires a current Android-enabled download for Windows (x64 / x86 / ARM64), macOS (Apple silicon / Intel) or Linux (x86_64 / ARM64).
Requires --session SESSION.
rdp-cli android text --help
Trust, credentials and installation
trust records apply to an exact RDP target and fingerprint in strict certificate mode. credentials remove deletes only the named product credential reference. On macOS and Linux, install-cli/uninstall-cli manage the CLI entry and --prefix chooses the installation location; Windows runs the downloaded executable directly. presence show --panel opens the session panel on macOS and Linux. licenses prints the bundled third-party versions and notices.
rdp-cli trust list#
List scoped RDP certificate trust records
A session is not required; optional session selection is listed below where supported.
rdp-cli trust list --help
rdp-cli trust add#
Trust one target certificate fingerprint
A session is not required; optional session selection is listed below where supported.
rdp-cli trust add --help
rdp-cli trust remove#
Remove one target trust record
A session is not required; optional session selection is listed below where supported.
rdp-cli trust remove --help
rdp-cli credentials remove#
Remove one product credential-store item
A session is not required; optional session selection is listed below where supported.
rdp-cli credentials remove --help
rdp-cli install-cli#
Install the CLI entry on macOS or Linux
A session is not required; optional session selection is listed below where supported.
rdp-cli install-cli --help
rdp-cli uninstall-cli#
Remove the CLI entry point created by rdp-cli
A session is not required; optional session selection is listed below where supported.
rdp-cli uninstall-cli --help
rdp-cli licenses#
Show third-party versions and license notices
A session is not required; optional session selection is listed below where supported.
rdp-cli licenses --help
Agent tasks and automation
Added screen regions and image comparison, conditional waits, action batches, persistent task reports, named Agent collaboration, MCP with connection profiles and diagnostics, and Android virtual displays.
rdp-cli tasks create#
Create a persistent task
A session is not required; optional session selection is listed below where supported.
rdp-cli tasks create --help
rdp-cli tasks list#
List authorized tasks
A session is not required; optional session selection is listed below where supported.
rdp-cli tasks list --help
rdp-cli tasks status#
Read task progress and history
A session is not required; optional session selection is listed below where supported.
rdp-cli tasks status --help
rdp-cli tasks attach#
Attach an authorized session to a task
Requires --session SESSION.
rdp-cli tasks attach --help
rdp-cli tasks checkpoint#
Save a checkpoint without replaying input
A session is not required; optional session selection is listed below where supported.
rdp-cli tasks checkpoint --help
rdp-cli tasks new-run#
Start a new run from a checkpoint
Requires --session SESSION.
rdp-cli tasks new-run --help
rdp-cli tasks grants list#
List task permissions
A session is not required; optional session selection is listed below where supported.
rdp-cli tasks grants list --help
rdp-cli tasks grants grant#
Grant task permissions
A session is not required; optional session selection is listed below where supported.
rdp-cli tasks grants grant --help
rdp-cli tasks grants revoke#
Revoke future task access
A session is not required; optional session selection is listed below where supported.
rdp-cli tasks grants revoke --help
rdp-cli tasks evidence#
Save selected local evidence
A session is not required; optional session selection is listed below where supported.
rdp-cli tasks evidence --help
rdp-cli tasks export#
Export an offline JSON or HTML report
A session is not required; optional session selection is listed below where supported.
rdp-cli tasks export --help
rdp-cli tasks purge#
Purge selected local task history
A session is not required; optional session selection is listed below where supported.
rdp-cli tasks purge --help
rdp-cli agents register#
Register an Agent identity
A session is not required; optional session selection is listed below where supported.
rdp-cli agents register --help
rdp-cli agents list#
List Agent identities without secrets
A session is not required; optional session selection is listed below where supported.
rdp-cli agents list --help
rdp-cli agents show#
Read an Agent identity and permissions
A session is not required; optional session selection is listed below where supported.
rdp-cli agents show --help
rdp-cli agents revoke#
Revoke an Agent identity and its claims
A session is not required; optional session selection is listed below where supported.
rdp-cli agents revoke --help
rdp-cli agents grant#
Grant an Agent session access
Requires --session SESSION.
rdp-cli agents grant --help
rdp-cli agents revoke-access#
Revoke an Agent session access
Requires --session SESSION.
rdp-cli agents revoke-access --help
rdp-cli control claim#
Claim a paused session as a named Agent
Requires --session SESSION.
rdp-cli control claim --help
rdp-cli control renew#
Renew a valid control claim
Requires --session SESSION.
rdp-cli control renew --help
rdp-cli control unclaim#
Release the claim and pause the session
Requires --session SESSION.
rdp-cli control unclaim --help
rdp-cli control claim-status#
Inspect the current control claim
Requires --session SESSION.
rdp-cli control claim-status --help
rdp-cli control handoff#
Hand control to an authorized Agent
Requires --session SESSION.
rdp-cli control handoff --help
rdp-cli profiles list#
List saved connection profiles
A session is not required; optional session selection is listed below where supported.
rdp-cli profiles list --help
rdp-cli profiles show#
Read a profile and parameter sources
A session is not required; optional session selection is listed below where supported.
rdp-cli profiles show --help
rdp-cli profiles save#
Save a profile with credential references
A session is not required; optional session selection is listed below where supported.
rdp-cli profiles save --help
rdp-cli profiles remove#
Remove a profile without deleting credentials
A session is not required; optional session selection is listed below where supported.
rdp-cli profiles remove --help
rdp-cli profiles export#
Export a profile without secrets
A session is not required; optional session selection is listed below where supported.
rdp-cli profiles export --help
rdp-cli profiles import#
Import a profile without connecting
A session is not required; optional session selection is listed below where supported.
rdp-cli profiles import --help
rdp-cli doctor#
Diagnose capabilities; explicitly opt into a connection probe
A session is not required; optional session selection is listed below where supported.
rdp-cli doctor --help
rdp-cli doctor status#
Read a diagnostic result
A session is not required; optional session selection is listed below where supported.
rdp-cli doctor status --help
rdp-cli doctor cancel#
Cancel further diagnostic work
A session is not required; optional session selection is listed below where supported.
rdp-cli doctor cancel --help
rdp-cli wait#
Wait for a pixel or state condition
Requires --session SESSION.
rdp-cli wait --help
rdp-cli wait status#
Read a wait result
Requires --session SESSION.
rdp-cli wait status --help
rdp-cli wait cancel#
Cancel a wait without cancelling its target
Requires --session SESSION.
rdp-cli wait cancel --help
rdp-cli batch#
Run a prevalidated sequence of up to 64 steps
Requires --session SESSION.
rdp-cli batch --help
rdp-cli batch status#
Read a batch result without replay
Requires --session SESSION.
rdp-cli batch status --help
rdp-cli batch cancel#
Cancel pending batch steps
Requires --session SESSION.
rdp-cli batch cancel --help
rdp-cli operations cancel#
Cancel remaining input; sent input is not undone
Requires --session SESSION.
rdp-cli operations cancel --help
rdp-cli mcp stdio#
Serve MCP over standard input and output
A session is not required; optional session selection is listed below where supported.
rdp-cli mcp stdio --help