Execute bash command with automatic cluster routing.

Commands are automatically routed to optimal nodes based on:

• Current cluster load (CPU, memory, load average)

• Command characteristics (build/test/compile patterns)

• Node capabilities (OS, architecture)

Heavy commands (make, cargo, pytest, docker, etc.) are automatically offloaded. Simple commands (ls, cat, echo) run locally for speed.

Parameters:

• command (required): Bash command to execute

• requires_os (optional): Force specific OS (linux/darwin)

• requires_arch (optional): Force specific architecture (x86_64/arm64)

• auto_route (optional): Enable auto-routing (default: true)

Returns execution result with node info and output.

Get current cluster status and load distribution.

Shows real-time metrics for all cluster nodes:

• CPU usage percentage

• Memory usage percentage

• 1-minute load average

• Active task count

• Health status (healthy/overloaded)

• Reachability

Use this to:

• Check cluster health before heavy operations

• Determine optimal node for manual routing

• Debug cluster connectivity issues

• Monitor distributed execution

Returns JSON with status for each node.

Explicitly route command to specific cluster node.

Use when you need to:

• Run Linux-specific commands -> offload to macpro51

• Test on specific architecture

• Balance load manually

• Debug node-specific issues

Available nodes:

• macpro51: Linux x86_64 builder (docker, podman, compilation)

• mac-studio: macOS ARM64 orchestrator

• macbook-air: macOS ARM64 researcher

Parameters:

• command (required): Bash command to execute

• node_id (required): Target node ID

Returns execution result from specified node.

Execute multiple commands in parallel across cluster.

Distributes commands across available nodes for maximum parallelism. Use for:

• Running test suites across multiple files

• Parallel builds

• Batch processing

• Load testing

Commands are automatically distributed based on node availability and load.

Parameters:

• commands (required): List of bash commands to execute in parallel

Returns list of results, one per command, with execution details.