Menu
Use for dispatching a command from the current git repo to a remote machine in order to offload work for execution.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Use when the user wants to run a long or resource-heavy task on another computer so their local machine stays free, the work continues if they close their laptop or lose connection, and the result returns as a reviewable branch in their project. Use this skill also when no offload target exists yet and the user needs help setting one up.
Clone GitHub repos on this machine with ghwc: canonical owner/repo casing, shared bare clone, branch-named sibling worktrees under ~/Projects.
Use this skill for any task involving the ambit CLI: creating or destroying private networks, deploying apps to a private network, checking network or router health, listing routers, diagnosing connectivity problems, managing app secrets, or streaming app logs. Trigger phrases include "create a network", "set up ambit", "deploy with ambit", "ambit create", "ambit deploy", "ambit doctor", "check router status", "destroy a network", "managing app secrets", "streaming app logs", and similar.
Use when inspecting state, output, completion, or worktree activity for Codex goal runs launched by Boondoggle.
Use when launching a persistent Codex goal run with `boondoggle` from a prompt on stdin.
Use this to check or configure auth and config state on a remote device via a Foolfad transport -- this is `foolfad-configure`.
| name | foolfad |
| description | Use for dispatching a command from the current git repo to a remote machine in order to offload work for execution. |
Use foolfad when the user wants a command from the current git repository to run in a matching worktree on a remote target machine.
Run it from inside the source repository. Foolfad pushes the current HEAD to the selected repo remote, pushes a run branch named foolfad/<run-id>, reaches the target through a transport command, creates or refreshes the target worktree, and runs the requested command there.
Typical usage:
foolfad -- npm run dev
foolfad -- npm run test
foolfad -- bash scripts/start.sh --port 3000
foolfad --command 'npm run dev'
FOOLFAD_COMMAND='npm run test' foolfad
Foolfad is provider-agnostic. It reaches the target through a transport: one local command that reads a script on stdin, runs it under bash -s on the remote, and forwards stdout, stderr, and exit status.
Set the transport with FOOLFAD_TRANSPORT or --transport. Multiple adapters ship with the project, and any command with the same stdin/stdout/stderr/exit-status contract can be used:
export FOOLFAD_TRANSPORT='foolfad-ssh box.lab' # plain SSH
export FOOLFAD_TRANSPORT='foolfad-tailscale box.lab' # Tailscale SSH
export FOOLFAD_TRANSPORT='foolfad-fly --app my-app --machine 0123456789' # Fly.io
foolfad -- npm run test
The adapter named in the transport must be on PATH. For SSH and Tailscale, the first argument is the host; extra args pass through to the adapter. Foolfad has no default transport, so one must be set before launch.
Before launching, confirm these are true:
FOOLFAD_TRANSPORT (or --transport), and the named transport command is installed.FOOLFAD_REPO_URL is set explicitly.If the repo has no remote, set FOOLFAD_REPO_URL. If the desired remote is not the current upstream or origin, set FOOLFAD_REMOTE_NAME.
FOOLFAD_REPO_ROOT sets the source repo root when $PWD is not enough.FOOLFAD_REPO_URL sets the remote URL pushed to and cloned from.FOOLFAD_REMOTE_NAME selects which local git remote to use.FOOLFAD_REPO_PATH overrides the target repo path segment under repos/.FOOLFAD_RUN_ID fixes the run id instead of generating one.FOOLFAD_WORKTREE_NAME overrides the target worktree directory name. By default it is derived from the run branch, so foolfad/<run-id> becomes foolfad-<run-id>.FOOLFAD_RUN_BRANCH overrides the pushed run branch.FOOLFAD_BASE_BRANCH records the source branch used as the base branch.FOOLFAD_REMOTE_ROOT changes the target root, defaulting on the remote to ~/.remote-work.FOOLFAD_REMOTE_DIR, FOOLFAD_BARE_DIR, and FOOLFAD_WORKTREE_DIR override the exact remote directories.FOOLFAD_COMMAND provides a shell command when not using --command or -- COMMAND.FOOLFAD_TRANSPORT sets the transport command; --transport overrides it per call.After dispatching, report:
foolfad/<run-id>
~/.remote-work/repos/<repo-path>/foolfad-<run-id>
For later status checks on the target machine, use the foolfad-target skill.