remote-client

Remote Client

Overview

Use the FlowLLM lite remote_client flow to call a running remote_server over HTTP. Prefer it when work should execute on a configured remote project host instead of the local Codex shell.

The implementation lives in flowllm/lite/flow/remote_client_flow.py; the paired server endpoints live in flowllm/lite/flow/remote_server_flow.py.

Before Running

Confirm the target host and port before launching remote work:

fl --remote-client --action ping

If --host is omitted, remote_client_flow.py reads DEFAULT_REMOTE_HOST_ENV. If neither is set, it raises Remote host is required. Set DEFAULT_REMOTE_HOST_ENV or pass --host.

Use --host only when overriding DEFAULT_REMOTE_HOST_ENV. Use --port only when the server is not on the default 8765.

Actions

Run a shell command remotely and stream stdout/stderr back to the local terminal:

fl --remote-client --action exec --command "pytest tests/unit"

Run a command stored in a local file:

fl --remote-client --action exec --command-file /path/to/command.sh

Upload and run a local Python file on the remote server:

fl --remote-client --action exec --python-file /path/to/script.py

Inspect tracked remote tasks:

fl --remote-client --action tasks
fl --remote-client --action tasks --status running --tail 80

Terminate a task or all running tasks:

fl --remote-client --action kill --task-id 12
fl --remote-client --action kill_all

Parameters

• --action: one of exec, ping, tasks, kill, kill_all; default is exec.
• --host: remote host. Falls back to DEFAULT_REMOTE_HOST_ENV.
• --port: remote server port; default is 8765.
• --timeout: command timeout in seconds; default is 3600.
• --command: shell command string for exec.
• --command-file: local text file whose contents become the remote shell command.
• --python-file: local Python file uploaded as code and run by the remote Python interpreter.
• --status: optional task status filter for tasks, commonly running, finished, or killed.
• --tail: output lines to include per task for tasks; default is 30.
• --task-id: required for kill.