MindExec Remote Agent

Run a direct MindExecution remote agent from a controlled computer.

npx @mindexec/remote connect --manager 127.0.0.1:5197 --pair <token>

For LAN use, start the manager RemoteHub with an externally reachable host and port, then point agents at that address:

$env:REMOTE_HUB_HOST="0.0.0.0"
$env:REMOTE_HUB_PORT="5197"
$env:REMOTE_HUB_PAIR_TOKEN="<strong-token>"
npx @mindexec/cli

npx @mindexec/remote connect --manager 192.168.0.10:5197 --pair <strong-token>

The agent registers the device, sends status heartbeats, can return manager-requested low-resolution thumbnails, can stream a focused view-only live screen when the manager requests it, and can receive safe remote agent instructions.

By default, the launcher uses the packaged C# RemoteFast engine when supported. RemoteFast connects to the manager with WebSocket and sends each screen frame as one binary message containing frame.binary metadata plus raw JPEG/PNG bytes, so screen frames do not travel as base64 JSON. The current C# capture backends are:

• Windows x64: Graphics.CopyFromScreen JPEG fallback.
• macOS arm64/x64: screencapture + sips JPEG fallback. macOS Screen Recording permission is required.

The launcher automatically falls back to the legacy Node engine when AI assist is requested or when a compatible .NET runtime is unavailable.

By default, task dispatch is task-only: the agent records and reports the instruction but does not perform shell, file, input, browser, or persistent side effects.

OpenAI-backed text-only AI assist is opt-in per controlled computer:

$env:OPENAI_API_KEY="<key-on-this-controlled-computer>"
npx @mindexec/remote connect --manager 192.168.0.10:5197 --pair <strong-token> --ai

AI assist calls the configured model and returns text output. It still does not perform shell, file, input, browser, or persistent side effects.

Useful development flags:

npx @mindexec/remote connect --manager 127.0.0.1:5197 --pair <token> --no-thumbnail
npx @mindexec/remote connect --manager 127.0.0.1:5197 --pair <token> --no-live
npx @mindexec/remote connect --manager 127.0.0.1:5197 --pair <token> --no-tasks
npx @mindexec/remote connect --manager 127.0.0.1:5197 --pair <token> --ai --ai-model gpt-5.4-mini
npx @mindexec/remote connect --manager 127.0.0.1:5197 --pair <token> --fake-thumbnail
npx @mindexec/remote connect --manager 127.0.0.1:5197 --pair <token> --fake-ai
npx @mindexec/remote connect --manager 127.0.0.1:5197 --pair <token> --engine node
npx @mindexec/remote connect --manager 127.0.0.1:5197 --pair <token> --engine fast
npx @mindexec/remote connect --manager 127.0.0.1:5197 --pair <token> --engine fast --transport tcp
npx @mindexec/remote connect --manager 127.0.0.1:5197 --pair <token> --engine fast --trace-frames