@myagentroam/node

MyAgentRoam Node runtime CLI for Linux and Windows.

For third-party deployment, registration, Runner prerequisites, and automatic startup, see the public Node deployment and connection guide at /docs/deployment/node-installation in your MyAgentRoam Server Web Console. The same guide is also linked from Settings → Node registration.

Requirements

• Node.js >=22.13 <25
• A private Node configuration file containing the Server URL, Node credential, local data path, and allowed workspace root directories

The allowedRoots setting is an array, so one Node can expose multiple independent workspace root directories:

{
  "serverUrl": "https://server.example",
  "allowedRoots": ["/home/mar-node/projects", "/srv/workspaces"]
}

Every configured root is checked independently before a Workspace, file, or directory operation is allowed. If allowedRoots is omitted, the platform default root is used.

Install and run

npm install --global @myagentroam/node@latest
mar-node run --config /path/to/mar-node.json

Managed deployments should run the stable supervisor entrypoint instead:

mar-node supervise --config /path/to/mar-node.json

The supervisor only installs an exact version requested by an authenticated Server operation. It never follows the npm latest tag automatically.

The package contains only the executable and its runtime dependencies. It never includes Node configuration, credentials, SQLite data, workspaces, or Runner credentials.