fm-executor

Connect your local machine to the Future Machine platform as an AI executor node. Tasks are pulled from the platform and executed locally using Claude Code CLI.

Requirements

• Node.js >= 18
• Claude Code CLI installed (claude command available)

Usage

Register and start with your API Key (one command):

npx fm-executor start --token fm_sk_...

With a local proxy:

npx fm-executor start --token fm_sk_... --proxy http://127.0.0.1:7890

Reuse an existing node (if config was lost):

npx fm-executor start --token fm_sk_... --executor-id <id>

Commands

fm-executor start    Start the executor and connect to FM platform
fm-executor status   Show current node status
fm-executor reset    Clear local registration info

Options (start)

| Option | Description | |--------|-------------| | --token <key> | API Key (fm_sk_... registers a new node, fm_ex_... reuses existing) | | --executor-id <id> | Node ID (use with fm_sk_... to recover a lost config) | | --server <url> | Server URL (default: https://fmo.onenorthdev.com) | | --name <name> | Node name (default: hostname) | | --proxy <url> | Local proxy URL, passed through to Claude subprocess | | --log-level <level> | Log level: debug/info/warn/error (default: info) |