Loading...
Loading...
Orchestrate headless Claude Code (`claude -p`) and Codex (`codex exec`) workers on a remote Linux SSH host (default `jetson`, override with REMOTO_HOST) from the local session: probe hosts, spawn jobs, wait, collect results, cross-review across providers, report fleet status. Use when work should run on a remote box (its GPU, files, environment) while this session coordinates: 'run this on the jetson', 'spawn remote agents', 'remote swarm', 'status of the remote jobs', 'córrelo en el jetson', 'lanza agentes remotos', 'cómo van los jobs remotos'. Also for checking or collecting jobs spawned earlier. NOT for local-only work or local subagents, and NOT usable without an SSH host that has key auth and a logged-in claude or codex.
npx skill4agent add jairotorregrosa/jaiskills remote-agentsclaude -pcodex execREMOTO="${CLAUDE_SKILL_DIR}/scripts/remoto.sh" # other harnesses: absolute path of scripts/remoto.sh beside this SKILL.mdREMOTO_HOST=gpu-box $REMOTO ls| Variable | Effect | Default |
|---|---|---|
| Host every command targets | |
| Second host | |
| Explicit list for | |
ssh <host>user@ipsetsidclaudecodex~/.remoto/jobs/<id>/$ARGUMENTSstatus [job-id ...]--host <h>REMOTO_HOST=<h>--engine codex|claude|bothcodexboth--dir <path>'~/code/x'| Role | Who | Spawn flags |
|---|---|---|
| Orchestrator | This session. Never delegated. | — |
| Implementer (default) | Codex at high reasoning | |
Implementer (alt: user asks for Claude, or | Claude Code headless | |
| Reviewer | The engine that did NOT write the work | per engine above |
| Judge (final verdict on a review loop) | The engine that did NOT write the work, so the author's provider never grades itself (default Codex implementer → Claude judge) | |
-mmodel~/.codex/config.toml-m <name>hosts-r/--effort low|medium|high|xhighmodel_reasoning_effort| Command | Purpose |
|---|---|
| Probe hosts: UP/DOWN, CLI versions, load; first line names the target |
| Launch a worker, prompt on stdin. Prints the job id |
| Fleet / job state: RUNNING, DONE, FAILED(rc), DEAD, MISSING |
| Block until all finish (poll 15 s, default timeout 7200). Exit 0 all DONE, 1 any failed, 124 timeout |
| Tail stderr + stdout |
| Final answer (claude: parsed from stream-json; codex: last message) |
| Kill the process group / delete finished job dirs |
| rsync payloads and artifacts (mind trailing slashes) |
| Usage |
$REMOTO hosts$REMOTO status <ids>$REMOTO result <id>$REMOTO ls$REMOTO logs <id>$REMOTO hostsREMOTO_HOST=<fallback>ssh <host> 'ls <dir>'$REMOTO push$REMOTO spawn -e codex -r high -d '~/code/project' -n api-worker - <<'PROMPT'
...full self-contained prompt...
PROMPT$REMOTO wait <ids>run_in_background: truelogsstatusresult <id>logs <id>$REMOTO pull$REMOTO clean--dangerously-skip-permissions--dangerously-bypass-approvals-and-sandbox--safeacceptEdits--sandbox workspace-writels