This project might be overkill, but I just wanted a fast, straightforward way to run commands on the machines I work with, especially through LLMs. Setting up SSH each time is cumbersome (and sometimes not possible for protected nodes). The machine just needs outbound internet connectivity. And nothing needs to be installed on the calling side, a simple curl command works.

Use cases can vary, but I think it's good for infra work like debugging a node that's misbehaving, checking logs, setting up a VM with Coolify, Dokploy, etc.

How it works: you install the susan binary on the machine with a single command and run it. It prints a curl string that any LLM (or you) can use to talk to the machine. The connection is ephemeral, so once the susan command is killed, the auth dies with it.

One thing to note: by default, susan connects to the public relay I run. That can be a concern for more private use cases, so I also provide a binary to self-host your own relay (called tray, keeping with the lazy susan theme).