remote

Runs commands and transfers files on remote hosts via a BatchMode SSH wrapper.

Updated Jan 19, 2023
One-click install
npx skills add https://github.com/inkfin/dotfiles --skill remote-inkfin
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: remote
Source: https://github.com/inkfin/dotfiles/tree/main/dot_agents/skills/exact_remote
Command: npx skills add https://github.com/inkfin/dotfiles --skill remote-inkfin

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Agents and users often need to inspect logs, check services, or move files on machines that have no interactive session, and hand-rolled ssh/scp commands are error-prone with quoting, authentication prompts, and inconsistent login environments. ## Core Features & Use Cases - Non-interactive command execution: remote run <host> -- <cmd> executes commands under a remote login shell with BatchMode, ControlMaster reuse, and propagated exit codes. - File transfer: remote get and remote put move files between hosts without opening an interactive SSH session, supporting stdout streaming or explicit output paths. - Use Case: A dispatched coding agent needs evidence from a production box: it runs remote run workbox -- journalctl -u myapp -n 200 --no-pager, pulls the error log with remote get, and writes its findings report on the local machine. ## Quick Start Ask the agent to check the application logs on the workbox host using the remote run command and summarize the findings in a local report file.

Frequently Asked Questions about remote

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run a command on a remote server without an interactive SSH session?

Use `remote run <host> -- <cmd>` to execute commands non-interactively over SSH with BatchMode enabled. The command runs under a remote login shell so PATH matches an interactive session, and exit codes propagate back to the caller.

How to copy files from a remote host using SSH?

Use `remote get <host> <remote-path>` to stream a remote file to stdout, or add `-o <local-path>` to save it locally. To upload, use `remote put <host> <local-path> <remote-path>`.

Why does the remote command fail with authentication errors?

The wrapper requires non-interactive SSH auth with BatchMode=yes, so password prompts are impossible. Load passphrase-protected keys into ssh-agent with ssh-add first, and verify plain `ssh <host>` works before debugging the wrapper.

Can I use remote for interactive TUI sessions or full remote agent work?

No, the skill is strictly for non-interactive command execution and file transfer. Interactive TUI attach uses `herdr --remote <host>`, and full coding-agent sessions on a remote checkout should run directly on that host instead.

How do I run a command in a specific directory on a remote machine?

Pass the `--cwd` flag before the command: `remote run <host> --cwd /srv/app -- ls -lt`. This changes the working directory on the remote side before executing the command.