KW-REMOTE(1)

💖 kw-remote 💖

okay bestie, so this is kw-remote(1) — the page that lives in the manual, and it's literally about keeping your test machines organized. main character energy for your dev setup, no cap. 🎀

✨ NAME ✨

kw-remote — Manage set of tracked test machines 🌸

---

🌈 SYNOPSIS 🌈

okay so here's every single way you can call her, verbatim, don't freestyle:

kw remote [-v | --verbose]
kw remote [--global] --add <name> <user>@<remote>[:<port>]
kw remote [--global] --remove <name>
kw remote [--global] --rename <old-name> <new-name>
kw remote [--global] --list
kw remote [--global] -s<name> | --set-default=<name>

---

🦋 DESCRIPTION 🦋

Manage the set of test machines ("remotes") you want kw to have easy access. This feature directly interacts with kw configuration for remote available locally at .kw/remote.config or globally at ~/.config/kw/remote.config.

that's it that's the vibe — it's your little contact list of test machines, and it's stored in one of those two config files depending on whether you're being local or global about it. 💅

---

👑 OPTIONS 👑

• --add <name> <remote-address> — Adds a remote named <name> for the test machine at <remote-address>. Notice that <remote_address> must follow the pattern <user>@<remote>[:<port>] where remote can be an IP or a name server and :<port> is optional (default port is 22). ⭐
• --remove <name> — Remove the remote named <name>. bye bestie 🫶
• --rename <old-name> <new-name> — Rename the remote named <old-name> to <new-name>. If you try a name already in use, kw will fail with a message. so like, pick a name that's actually free, okay? 😭
• --list — List all available remotes. ✨
• --global — Force use global config file instead of the local one. 🌍
• -s<name>, --set-default=<name> — Set default remote to remote named <name>. 👑
• -v, --verbose — Be a little more verbose and show remote url after name. lowkey essential iykyk 💖

heads up: --global is the one that flips you from the local config over to the global one. don't forget it exists, it's giving sneaky.

---

🎀 EXAMPLES 🎀

In case you want kw to track a new test machine, you can use:

cd <kernel-path>
kw remote --add origin root@my-test-machine

If you do not use port 22, you can use:

kw remote --add my-x86-test-system root@my-test-machine:5555

If you want to remove some remote:

kw remote --remove origin

If you want to rename:

kw remote --rename origina arm-device

You can also list all your available remotes via:

kw remote --list

If you want to set the default remote:

kw remote --set-default=new-default-remote

---

ok that's the whole page, every last flag and path and example, ate and left no crumbs 💅

---

and for the cute sign-off: the footer on this page just reads kw-remote - Mana...ked test machines() — that's the source/version-and-date line, trimmed right down, so that's what we're working with bestie. 🦋✨💜