Skip to content

CLI reference

jump nodes list List paired nodes
jump nodes add <name> <host[:port]> --code <code>
Pair (or re-pair) a node; port defaults to 7420
jump nodes remove <name> Forget a node
jump info <node> Show node details
jump run [--timeout-secs N] <node> <command…>
Run a command (default timeout 60 s), print its
output, exit with its code
jump push [--mode create|overwrite|append] [--create-dirs] <node> <local> <remote>
Copy a local file to an absolute path on the
node (up to 256 MiB; create fails if it exists)
jump screenshot [--display N] [--max-size N] <node> <file.png>
Save a screenshot of a node's display (full
size by default; replaces <file.png>)
jump ui tree [--window H] [--element ID] [--max-depth N] [--max-elements N] <node>
Print a window's accessibility tree
jump ui act <node> <element> <action> [value]
Act on an element: click, focus, set-value,
toggle, expand, collapse, select, scroll-into-view
jump ui click [--display N] [--button B] [--double] <node> <x> <y>
jump ui scroll [--display N] <node> <x> <y> <amount>
jump ui type <node> <text>
jump ui keys <node> <combo>… Raw mouse and keyboard input
jump identity Print this bridge's fingerprint
jump mcp Serve MCP on stdio
jump-agent [serve] [--no-tray] Run the agent (default), with a tray icon on a
desktop
jump-agent pair Create a one-time pairing code
jump-agent identity Print this node's fingerprint
jump-agent bridges list List paired bridges
jump-agent bridges revoke <name|fingerprint>
Stop trusting a bridge
jump-agent autostart enable|disable|status Start the agent at login, or stop doing so

Notes on jump run:

  • Put options before the node name. Everything after the node name is part of the command, including anything that looks like an option.
  • Quote the command when it contains shell syntax: jump run build-box 'make test | tail'.
  • The exit code is the remote command’s. It is 1 if the command timed out, was killed by a signal, or exited with a code outside 0–255 (common for crashes on Windows).