remote-process-server

3.2.2 verified Sat Apr 25 auth: no javascript

A client/server system for remotely creating and managing processes over a framed process-control protocol on top of a trusted byte stream. Current stable version is 3.2.2, with frequent releases (bugfixes every few months). The project keeps the server side small, dependency-free, and easily launchable in many environments (C++ server, Python manager, Node.js CLI). It supports custom server launch commands via SSH, npx, or direct paths, making it flexible for remote process management. Deprecated versions v3.1.0 and v3.1.1 should not be used.

Common errors

error remote-process-server: command not found ↓

cause CLI wrapper not installed globally or not in PATH.

fix

Run 'npm i -g remote-process-server@latest' or use 'npx remote-process-server'.

error Python not found or not installed ↓

cause Python 3 runtime is required for the client.

fix

Install Python 3 (>=3.6) from python.org or via your system package manager.

error Error: --server argument requires full command line ↓

cause The value passed to --server is a path without the executable name or contains spaces unescaped.

fix

Ensure the argument is a full command line (e.g., 'ssh user@host /path/to/server.bin') and wrap paths with spaces: daemon --server="\"path with space/exe\""

Warnings

deprecated Versions 3.1.0 and 3.1.1 are deprecated and should not be used due to critical issues. ↓

fix Upgrade to version 3.2.2 or later.

breaking v3.0.0 introduced breaking changes from v2.x; check changelog for migration. ↓

fix Review the changelog at https://github.com/shc0743/remote-process-server/compare/v2.0.0...v3.0.0

gotcha The --server argument requires the full command line, and paths with spaces must be double-wrapped in quotes. ↓

fix Use: daemon --server="\"path with space/executable file\""

Install

npm install remote-process-server

yarn add remote-process-server

pnpm add remote-process-server

Imports

remote-process-server
wrong
```
npm start remote-process-server
```
correct
```
npx remote-process-server@latest daemon
```
CLI is invoked via npx or global install; not a JavaScript API
install
wrong
```
npm install remote-process-server
```
correct
```
npx remote-process-server@latest install
```
Install subcommand extracts server binary; npm install only installs CLI wrapper

run

wrong

remote-process-server run echo hello

correct

remote-process-server run -- echo hello

Use -- to separate command arguments

Quickstart

Install global CLI, start daemon, run a command, then stop the daemon.

npm i -g remote-process-server@latest
remote-process-server daemon &
sleep 2
remote-process-server run -- echo hello
remote-process-server stop